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ță
Job creat și pus în coadă.
Sarcina furnizorului rulează.
Adresa URL a imaginii rezultate este disponibilă.
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/