Stato e webhook -UlazAI

Tieni traccia delle generazioni asincrone

La generazione delle immagini è asincrona. Inizia con /api/v1/generate/, poi sondaggio /api/v1/generate/{generation_id}/ finché il lavoro non arriva completed o failed.

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

Stati del ciclo di vita

in sospeso

Lavoro creato e messo in coda.

elaborazione

L'attività del provider è in esecuzione.

completato

L'URL dell'immagine del risultato è disponibile.

fallito

Errore restituito, i crediti vengono rimborsati.

Esempi di risposte di stato

Elaborazione

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

Completato

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

Fallito

{
  "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."
  }
}

Richiamate

I processi endpoint unificati utilizzano internamente gli URL di callback firmati. Richiamata la gestione è gestita da UlazAI e non richiede la configurazione lato client.

Gli endpoint Nano Banana legacy espongono anche l'elaborazione del webhook in:

/nano-banana/webhook/

UlazAI documenti