Estado y webhooks

Seguimiento de generaciones asíncronas

La generación de imágenes es asíncrona. Empezar con /api/v1/generate/, luego encuesta /api/v1/generate/{generation_id}/ hasta que el trabajo llegue completed o failed.

curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Estados del ciclo de vida

pendiente

Trabajo creado y en cola.

procesamiento

La tarea del proveedor se está ejecutando.

completado

La URL de la imagen del resultado está disponible.

falló

Se devolvió el error, se reembolsan los créditos.

Ejemplos de respuesta de estado

Tratamiento

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by queue",
    "prompt": "...",
    "message": "Generating your image..."
  }
}

Terminado

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "completed",
    "image_url": "https://media.ulazai.com/.../image.png",
    "prompt": "...",
    "credits_used": 8
  }
}

Fallido

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "failed",
    "error_message": "Prompt violates content policy",
    "message": "Generation failed. Credits have been refunded."
  }
}

Devoluciones de llamada

Los trabajos de punto final unificados utilizan URL de devolución de llamada firmadas internamente. Devolución de llamada el manejo lo gestiona UlazAI y no requiere configuración del lado del cliente.

Los puntos finales heredados Nano Banana también exponen el procesamiento de webhooks en:

/nano-banana/webhook/

Documentos UlazAI