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, eller403utan att ändra ingång eller autentisering. - Försök igen
500med exponentiell backoff och idempotens inskrivning i ditt applager. - Slutpunkt för undersökningsstatus innan dubblettgenereringsjobb startas.