UlazAI kehittäjädokumentit
Tila ja webhookit
Seuraa asynkronisia sukupolvia
Kuvan luonti on asynkronista. Aloita /api/v1/generate/,
sitten kysely /api/v1/generate/{generation_id}/ kunnes työ saapuu
completed tai failed.
curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
-H "Authorization: Bearer YOUR_API_KEY"
Elinkaaritilat
Työ luotu ja asetettu jonoon.
Palveluntarjoajan tehtävä on käynnissä.
Tuloskuvan URL-osoite on saatavilla.
Virhe palautettu, hyvitykset palautetaan.
Esimerkkejä tilavastauksista
Käsittely
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "processing",
"estimated_time": "varies by queue",
"prompt": "...",
"message": "Generating your image..."
}
}
Valmis
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "completed",
"image_url": "https://media.ulazai.com/.../image.png",
"prompt": "...",
"credits_used": 8
}
}
Epäonnistui
{
"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."
}
}
Takaisinsoittoja
Yhdistetyt päätepistetyöt käyttävät sisäisesti allekirjoitettuja takaisinsoitto-URL-osoitteita. Takaisinsoitto käsittelyä hallitsee UlazAI, eikä se vaadi asiakaspuolen asetuksia.
Vanhat Nano Banana-päätepisteet paljastavat myös webhook-käsittelyn osoitteessa:
/nano-banana/webhook/