Hoppa till innehållet

UlazAI utvecklardokument

Fel och gränser

Felhantering och plattformsbegränsningar

Använd strukturerad hantering för API-fel och validera indata på klientsidan för att minska försök igen.

Vanliga HTTP-svar

Kod Mening Typisk orsak
400 Ogiltig begäran Saknar prompt, storlek som inte stöds, ogiltiga modellparametrar
401 Obehörig Saknade eller ogiltig API-nyckel/sessionstoken
402 Betalning krävs Otillräckliga köpta krediter eller API åtkomstbegränsning
403 Förbjudet API register-/inloggningsslutpunkter är avsiktligt inaktiverade
404 Hittade inte Generations-ID ägs inte av nuvarande användare eller slutpunktsfel
500 Serverfel Uppströms leverantörsfel eller nätverkstimeout

Begärangränser för att upprätthålla klientsidan

  • prompt: max 5000 tecken på enhetlig slutpunkt.
  • image_urls: max 14 webbadresser på unified endpoint.
  • size: modellspecifik, validera mot modellmatris.
  • quality: modellspecifika värden för Seedream 5 Lite, Nano Banana 2, Ideogram och Qwen.
  • Användning av API kräver köpta krediter; välkomstkrediter är endast för webbplatsen.

Försök strategi igen

Rekommenderat produktionsbeteende:

  • Försök inte igen 400, 401, 402, eller 403 utan att ändra ingång eller autentisering.
  • Försök igen 500 med exponentiell backoff och idempotens inskrivning i ditt applager.
  • Slutpunkt för undersökningsstatus innan dubblettgenereringsjobb startas.