Consultar tarea de imagen asíncrona

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

Consulta una tarea asíncrona de imagen. Repite la consulta hasta que la tarea alcance un estado terminal.

Autenticación

Authorization Bearer

Parámetros de ruta

task_idstringrequired

ID de tarea con el prefijo img_task_.

Respuesta

idstring

ID de la tarea.

objectstring

image_generation.task

modelstring

Nombre público del modelo.

statusenum<string>
executionenum<string>

Modo de ejecución solicitado o resuelto.

versioninteger

Versión de la tarea.

resultobject

Respuesta estándar de imagen cuando status=completed.

errorobject

Detalles del error cuando status=failed o 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

Fecha y hora de creación en formato ISO-8601.

updated_atstring

Fecha y hora de la última actualización en formato ISO-8601.

completed_atstring

Fecha y hora de finalización en formato ISO-8601 cuando se completa.

needs_attention es terminal e indica que el resultado del envío al proveedor es ambiguo. No crees una tarea de reemplazo con una clave de idempotencia nueva; contacta con el soporte de Token360 e incluye el ID de tarea.

Solicitar

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

Respuesta completada

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}
¿Ha sido de ayuda?
Consultar tarea de imagen asíncrona · Token360