Crear tarea de imagen asíncrona
/v1/async/images/tasksCrea 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-KeystringClave de reintento recomendada, limitada al propietario autenticado. Máximo 200 caracteres.
Cuerpo de la solicitud
modelstringrequiredNombre público del modelo de imagen.
promptstringPrompt de imagen. Los requisitos dependen del modelo seleccionado.
executionenum<string>Preferencia de ejecución.
nintegerNúmero de imágenes.
sizestringTamaño solicitado, por ejemplo 1024x1024.
qualitystringCalidad solicitada cuando el modelo la admite.
output_formatstringFormato de salida solicitado cuando el modelo lo admite.
streambooleanDebe ser false u omitirse.
partial_imagesintegerNo compatible; omite este campo.
Se pueden proporcionar otros campos específicos del modelo aceptados por la API síncrona de imágenes.
Respuesta
idstringID de tarea con el prefijo img_task_.
objectstringimage_generation.task
modelstringNombre público del modelo.
statusstringEstado inicial, normalmente queued.
executionenum<string>Preferencia solicitada y, cuando esté disponible, modo de ejecución resuelto.
versionintegerVersión de la tarea que aumenta de forma monótona.
resultobjectRespuesta de imagen cuando una repetición idempotente devuelve una tarea ya completada.
errorobjectDetalles del error cuando una repetición idempotente devuelve una tarea failed o 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_atstringFecha y hora de creación en formato ISO-8601.
updated_atstringFecha y hora de la última actualización en formato ISO-8601.
completed_atstringFecha y hora de finalización en formato ISO-8601 cuando la tarea es terminal.