Retrieve async image task

GET/v1/async/images/tasks/{task_id}

Retrieve an asynchronous image task. Poll until the task reaches a terminal status.

Authentication

Authorization Bearer

Path Parameters

task_idstringrequired

Task ID with img_task_ prefix.

Response

idstring

Task ID.

objectstring

image_generation.task

modelstring

Public model name.

statusenum<string>
executionenum<string>

Requested or resolved execution mode.

versioninteger

Task version.

resultobject

Standard image response when status=completed.

errorobject

Error details when status=failed or needs_attention.

error.messagestring

Human-readable error message.

error.codestring

Machine-readable error code.

error.typestring

Error category when returned.

error.stagestring

Processing stage where the error occurred.

error.upstream_http_statusinteger

Provider HTTP status when the error came from upstream.

error.upstream_messagestring

Provider error message when available.

created_atstring

ISO-8601 creation time.

updated_atstring

ISO-8601 last update time.

completed_atstring

ISO-8601 completion time when completed.

needs_attention is terminal and means the provider submission outcome is ambiguous. Do not create a replacement task with a new idempotency key; contact Token360 support with the task ID.

Request

Shell
1curl https://api.token360.ai/v1/async/images/tasks/img_task_01abc \
2  -H "Authorization: Bearer sk-your-api-key"

Completed response

JSON
1{
2  "id": "img_task_01abc",
3  "object": "image_generation.task",
4  "model": "gpt-image-2.5-flare",
5  "status": "completed",
6  "execution": "provider",
7  "version": 9,
8  "result": {
9    "data": [{"url": "https://example.invalid/generated/image.png"}]
10  },
11  "created_at": "2026-09-21T12:00:00Z",
12  "updated_at": "2026-09-21T12:00:09Z",
13  "completed_at": "2026-09-21T12:00:09Z"
14}
Was this page helpful?
Retrieve async image task · Token360