Crear tarea de imagen asíncrona

POST/v1/async/images/tasks

Crea una tarea duradera de generación asíncrona de imágenes. El endpoint devuelve HTTP 202 inmediatamente; consulta Consultar tarea de imagen asíncrona para obtener el resultado.

El endpoint síncrono POST /v1/images/generations no cambia. Consulta Generación asíncrona de imágenes para ver el flujo completo.

Autenticación

Authorization Bearer

Clave de API como token bearer en el encabezado Authorization.

Encabezados

Idempotency-Keystring

Clave de reintento recomendada, limitada al propietario autenticado. Máximo 200 caracteres.

Cuerpo de la solicitud

modelstringrequired

Nombre público del modelo de imagen.

promptstring

Prompt de imagen. Los requisitos dependen del modelo seleccionado.

executionenum<string>

Preferencia de ejecución.

ninteger

Número de imágenes.

sizestring

Tamaño solicitado, por ejemplo 1024x1024.

qualitystring

Calidad solicitada cuando el modelo la admite.

output_formatstring

Formato de salida solicitado cuando el modelo lo admite.

streamboolean

Debe ser false u omitirse.

partial_imagesinteger

No compatible; omite este campo.

Se pueden proporcionar otros campos específicos del modelo aceptados por la API síncrona de imágenes.

Respuesta

idstring

ID de tarea con el prefijo img_task_.

objectstring

image_generation.task

modelstring

Nombre público del modelo.

statusstring

Estado inicial, normalmente queued.

executionenum<string>

Preferencia solicitada y, cuando esté disponible, modo de ejecución resuelto.

versioninteger

Versión de la tarea que aumenta de forma monótona.

resultobject

Respuesta de imagen cuando una repetición idempotente devuelve una tarea ya completada.

errorobject

Detalles del error cuando una repetición idempotente devuelve una tarea 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 la tarea es terminal.

Solicitar

Shell
1curl -X POST https://api.token360.ai/v1/async/images/tasks \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -H "Idempotency-Key: image-order-20260921-0001" \
5  -d '{
6    "model": "gpt-image-2.5-flare",
7    "prompt": "Un faro en acuarela al amanecer",
8    "size": "1024x1024",
9    "execution": "auto"
10  }'

Respuesta

JSON
1{
2  "id": "img_task_01abc",
3  "object": "image_generation.task",
4  "model": "gpt-image-2.5-flare",
5  "status": "queued",
6  "execution": "auto",
7  "version": 1,
8  "created_at": "2026-09-21T12:00:00Z",
9  "updated_at": "2026-09-21T12:00:00Z"
10}
¿Ha sido de ayuda?
Crear tarea de imagen asíncrona · Token360