Retrieve async image task
/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_idstringrequiredTask ID with img_task_ prefix.
Response
idstringTask ID.
objectstringimage_generation.task
modelstringPublic model name.
statusenum<string>executionenum<string>Requested or resolved execution mode.
versionintegerTask version.
resultobjectStandard image response when status=completed.
errorobjectError details when status=failed or needs_attention.
error.messagestringHuman-readable error message.
error.codestringMachine-readable error code.
error.typestringError category when returned.
error.stagestringProcessing stage where the error occurred.
error.upstream_http_statusintegerProvider HTTP status when the error came from upstream.
error.upstream_messagestringProvider error message when available.
created_atstringISO-8601 creation time.
updated_atstringISO-8601 last update time.
completed_atstringISO-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.