Sari la conținut

UlazAI documente pentru dezvoltatori

Stare și webhook-uri

Urmăriți generațiile asincrone

Generarea imaginilor este asincronă. Începe cu /api/v1/generate/, apoi sondaj /api/v1/generate/{generation_id}/ până când slujba ajunge completed sau failed.

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

Stările ciclului de viață

în aşteptare

Job creat și pus în coadă.

prelucrare

Sarcina furnizorului rulează.

completat

Adresa URL a imaginii rezultate este disponibilă.

a eșuat

Eroare returnată, creditele sunt rambursate.

Exemple de răspuns de stare

Prelucrare

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

Terminat

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

A eșuat

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

Reapeluri

Lucrările unificate pentru punctele finale folosesc URL-uri de apel invers semnate intern. Apel invers manipularea este gestionată de UlazAI și nu necesită configurare pe partea clientului.

Punctele finale vechi Nano Banana expun, de asemenea, procesarea webhook la:

/nano-banana/webhook/