Skip to main content

Endpoint: Check status & download result — guide (Deep Art API)

Updated

Category: Deep Art API
Section: Endpoints (basics)

Contents

Purpose

Query the processing status of a submission and, when finished, obtain the result URL to download the stylized image.

HTTP request

GET https://api.deeparteffects.com/v1/noauth/result?submissionId=<ID>

Query parameters

  • submissionId (required) — the identifier returned by the upload endpoint.

Authentication

This endpoint is available under /noauth/ and does not require an API key.

Response format

JSON object with a status field. When processing is complete, a url is provided.

Status values (as documented):

  • new
  • processing
  • finished
  • error

Example (processing):

{ "status": "processing" }

Example (finished):

{
  "status": "finished",
  "url": "https://.../result/<submissionId>.png"
}

Result links are time‑limited; download promptly and store the file on your side.

Polling recommendations

  • Start with a short interval (e.g., 1–2 s), then back off to avoid unnecessary requests.
  • Stop polling after you receive finished or error.
  • Avoid very tight loops to prevent 429 (Too Many Requests).

Example (cURL)

curl -X GET \
  "https://api.deeparteffects.com/v1/noauth/result?submissionId=subm_1234567890"

Handle the JSON response in your code; when status is finished, download the url shown.

Errors

  • 400 Bad Request — missing or malformed submissionId.
  • 404 Not Found — unknown submissionId (verify you’re using the value from the upload response).
  • 5xx — temporary server issue; retry after a short delay.

If you receive 401/403 on a noauth URL, double‑check the path; the noauth variant should not require credentials.

See also

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk