Status und Webhooks

Verfolgen Sie asynchrone Generationen

Die Bilderzeugung erfolgt asynchron. Beginnen Sie mit /api/v1/generate/, dann Umfrage /api/v1/generate/{generation_id}/ bis der Job erreicht ist completed oder failed.

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

Lebenszykluszustände

ausstehend

Job erstellt und in die Warteschlange gestellt.

Verarbeitung

Die Anbieteraufgabe wird ausgeführt.

abgeschlossen

Die URL des Ergebnisbilds ist verfügbar.

gescheitert

Fehler zurückgegeben, Credits werden zurückerstattet.

Beispiele für Statusantworten

Verarbeitung

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

Vollendet

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

Fehlgeschlagen

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

Rückrufe

Unified Endpoint-Jobs verwenden intern signierte Rückruf-URLs. Rückruf Die Handhabung wird von UlazAI verwaltet und erfordert keine clientseitige Einrichtung.

Ältere Nano Banana-Endpunkte stellen auch die Webhook-Verarbeitung bereit unter:

/nano-banana/webhook/

UlazAI-Dokumente