Dokumentacja programisty UlazAI
Stan i elementy webhook
Śledź generacje asynchroniczne
Generowanie obrazu jest asynchroniczne. Zacznij od /api/v1/generate/,
następnie ankieta /api/v1/generate/{generation_id}/ dopóki praca nie dotrze
completed lub failed.
curl -X GET https://ulazai.com/api/v1/generate/YOUR_GENERATION_ID/ \
-H "Authorization: Bearer YOUR_API_KEY"
Stany cyklu życia
Zadanie utworzone i umieszczone w kolejce.
Zadanie dostawcy jest uruchomione.
Adres URL obrazu wynikowego jest dostępny.
Zwrócono błąd, kredyty zostaną zwrócone.
Przykłady reakcji na status
Przetwarzanie
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "processing",
"estimated_time": "varies by queue",
"prompt": "...",
"message": "Generating your image..."
}
}
Zakończony
{
"success": true,
"data": {
"generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
"status": "completed",
"image_url": "https://media.ulazai.com/.../image.png",
"prompt": "...",
"credits_used": 8
}
}
Przegrany
{
"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."
}
}
Oddzwonienia
Ujednolicone zadania punktu końcowego korzystają wewnętrznie z podpisanych adresów URL wywołania zwrotnego. Oddzwonienie obsługa jest zarządzana przez UlazAI i nie wymaga konfiguracji po stronie klienta.
Starsze punkty końcowe Nano Banana udostępniają również przetwarzanie elementu webhook pod adresem:
/nano-banana/webhook/