Sari la conținut
UlazAI

UlazAI documente pentru dezvoltatori

Erori și limite

Prețuri Bord Studio de imagine

Gestionarea erorilor și limitele platformei

Utilizați gestionarea structurată pentru erorile API și validați intrările din partea clientului pentru a reduce reîncercări.

Răspunsuri HTTP comune

Cod Înțeles Cauza tipică
400 Solicitare nevalidă Lipsește promptul, dimensiunea neacceptată, parametrii de model nevalidi
401 Neautorizat Cheia API/indicativ de sesiune lipsă sau nevalid
402 Este necesară plata Credite achiziționate insuficiente sau restricție de acces API
403 Interzis Punctele finale de înregistrare/conectare API sunt dezactivate intenționat
404 Nu a fost găsit ID-ul generației nu este deținut de utilizatorul curent sau nepotrivirea punctului final
500 Eroare de server Eșecul furnizorului din amonte sau expirarea rețelei

Limite de solicitare pentru aplicarea din partea clientului

  • prompt: maxim 5000 de caractere pe punctul final unificat.
  • image_urls: maximum 14 adrese URL pe un punct final unificat.
  • size: specific modelului, validare împotriva matricea modelului.
  • quality: valori specifice modelului pentru Seedream 5 Lite, Nano Banana 2, Ideogram și Qwen.
  • Utilizarea API necesită credite achiziționate; creditele de bun venit sunt doar pentru site-ul web.

Reîncercați strategia

Comportament de producție recomandat:

  • Nu reîncercați 400, 401, 402, sau 403 fără a modifica intrarea sau autentificarea.
  • Reîncercați 500 cu backoff exponențial și introducerea idempotity în stratul de aplicație.
  • Sondați punctul final de stare înainte de a lansa joburi de generație duplicată.