Skip to main content

​
Descripción general

Todas las solicitudes de generación siguen el mismo ciclo de vida básico: Diagrama del ciclo de vida de un job

​
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 en result.urls failed El job falló debido a un error; los detalles están en result.error 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)
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 solicitud GET a /jobs/{id}. Prácticas recomendadas:
  • Consulta cada 2-5 segundos mientras el job esté pendiente (backlogged, queued, scheduled, processing, sampling o intermediate-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
Ejemplo de implementación de sondeo: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const job = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return job.result;
}

​
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

APIs de modelos

Explora todos los endpoints y parámetros disponibles

Claves de API y facturación

Crea y gestiona tus claves de API