Documentación de la APITrabajos y espera acotada
Sondear trabajo asíncrono y leer resultados depurados
Las operaciones con imágenes son trabajos duraderos. La primera respuesta
incluye el objeto de trabajo público completo y
Location: /api/v1/jobs/{job_id}.
Leer un trabajo
curl https://sci-draw.com/api/v1/jobs/job_012345 \
-H 'Authorization: Bearer sd_YOUR_KEY'Ámbito requerido: jobs:read. Los trabajos se leen por identificador y por
pertenencia a la cuenta. Un trabajo inexistente y uno de otra cuenta devuelven
ambos 404 JOB_NOT_FOUND.
Ciclo de estados
| Estado | Significado |
|---|---|
queued | aceptado y esperando ejecución |
processing | en curso |
succeeded | result.files está disponible |
failed | error contiene un código público estable y un mensaje |
canceled | el trabajo no se ejecutará |
Los estados terminales no vuelven a cambiar. Sondea los trabajos no terminales
con el valor Retry-After que devuelven las peticiones de creación; ahora mismo
se recomiendan dos segundos.
Espera acotada
Los endpoints de creación aceptan Prefer: wait=N, donde N es un entero de 1 a
30. Si el trabajo llega a un estado terminal dentro de esa ventana, el endpoint
devuelve 200. Si sigue en ejecución al vencer el plazo, devuelve el trabajo
actual con 202. Es adecuado para clientes interactivos, pero las integraciones
de servidor deben guardar siempre el identificador y estar listas para sondear.
Resultado correcto
{
"success": true,
"data": {
"id": "job_012345",
"object": "image_job",
"type": "image_generation",
"status": "succeeded",
"created_at": "2026-08-07T12:00:00.000Z",
"completed_at": "2026-08-07T12:00:41.000Z",
"credits_reserved":
Ninguna respuesta de trabajo contiene los prompts enviados, referencias a las imágenes de origen, identificadores internos, detalles de ejecución ni diagnósticos privados.