Síncrono y asíncrono
Síncrono: POST /v1/generate/image
Sección titulada «Síncrono: POST /v1/generate/image»La petición espera hasta que la imagen está generada y devuelve el resultado en la respuesta. Puede tardar desde unos segundos hasta varios minutos según el modelo y la resolución.
Úsalo para casos interactivos y volúmenes pequeños. Configura en tu cliente HTTP un timeout de al menos 5 minutos.
Asíncrono: POST /v2/jobs
Sección titulada «Asíncrono: POST /v2/jobs»La petición encola el trabajo y responde al momento con un id. El resultado se obtiene:
- con un webhook (
job.completed/job.failed), recomendado, o - consultando
GET /v2/jobs/:jobId.
Úsalo para lotes y producción. Los jobs se reintentan automáticamente (hasta 3 intentos) ante errores transitorios y devuelven los tokens si fallan definitivamente.
Workflows
Sección titulada «Workflows»POST /v2/workflows/:workflowId/run lanza un workflow y responde en cuanto la ejecución empieza. Consulta su estado con GET /v1/teams/:teamId/workflows/:workflowId/runs/:id.