UlazAI ontwikkelaarsdocumentatie
Status en webhooks
Volg asynchrone generaties
Het genereren van afbeeldingen is asynchroon. Begin met /api/v1/generate/,
dan peilen /api/v1/generate/{generation_id}/ totdat de baan bereikt is
completed of failed.
curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
-H "Authorization: Bearer YOUR_API_KEY"
Levenscyclusstatussen
Taak gemaakt en in de wachtrij geplaatst.
Providertaak wordt uitgevoerd.
URL van resultaatafbeelding is beschikbaar.
Fout geretourneerd, tegoeden worden terugbetaald.
Voorbeelden van statusreacties
Verwerking
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "processing",
"estimated_time": "varies by queue",
"prompt": "...",
"message": "Generating your image..."
}
}
Voltooid
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "completed",
"image_url": "https://media.ulazai.com/.../image.png",
"prompt": "...",
"credits_used": 8
}
}
Mislukt
{
"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."
}
}
Terugbelgesprekken
Uniforme eindpunttaken maken intern gebruik van ondertekende callback-URL's. Terugbellen de afhandeling wordt beheerd door UlazAI en vereist geen installatie aan de clientzijde.
Verouderde Nano Banana-eindpunten stellen ook webhook-verwerking bloot op:
/nano-banana/webhook/