Przejdź do treści

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

w toku

Zadanie utworzone i umieszczone w kolejce.

przetwarzanie

Zadanie dostawcy jest uruchomione.

ukończone

Adres URL obrazu wynikowego jest dostępny.

nie powiodło się

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/