Descripción general
Todas las solicitudes de generación siguen el mismo ciclo de vida básico:Estados del job
queued El job está esperando en la cola para ser procesado backlogged El job está esperando detrás de tu límite actual de concurrencia scheduled El job fue aceptado y programado para procesamiento processing El job está siendo procesado activamente por un worker sampling El job está generando muestras de salida intermediate-complete El job tiene un resultado intermedio y puede continuar procesándose completed El job terminó con éxito; el resultado está disponible enresult.urls
failed El job falló debido a un error. Los detalles están en el objeto error de nivel superior: code siempre está presente y message es opcional. Los rechazos de moderación usan code: "content_policy".
cancelled El job fue cancelado por el usuario o el sistema
Fallos y cancelación
Los jobs pueden fallar por varias razones:- Errores de la API del servicio de generación
- Parámetros inválidos o configuraciones no soportadas
- Moderación de contenido (filtrado NSFW)
- Detección automática de timeout (3 minutos para herramientas alojadas, 2 horas para proveedores externos)
error.code, el mensaje que lo acompaña y qué hacer a continuación se encuentran en Errores y depuración.
Para cancelar un job: envía una solicitud DELETE a /jobs/{id}. Nota: los jobs solo pueden cancelarse cuando tienen un estado queued o processing.
Importante: los jobs fallidos y cancelados no se facturan. Solo pagas por los jobs completados.
Consultar el estado de un job
Consulta el estado del job mediante una solicitudGET a /jobs/{id}. Prácticas recomendadas:
- Consulta cada 2-5 segundos mientras el job esté pendiente (
backlogged,queued,scheduled,processing,samplingointermediate-complete) - Usa retroceso exponencial para jobs de mayor duración
- Deja de consultar cuando el estado sea completed, failed o cancelled
- Algunos jobs pueden incluir imágenes de vista previa en las respuestas durante processing
Próximos pasos
Webhooks
Recibe notificaciones cuando los jobs se completen
Límites de tasa
Comprende los límites de la API según el nivel de tu plan
Errores y depuración
Errores HTTP y códigos de error de jobs fallidos
APIs de modelos
Explora todos los endpoints y parámetros disponibles
Claves de API y facturación
Crea y gestiona tus claves de API