UlazAI utviklerdokumenter
Feil og begrensninger
Feilhåndtering og plattformgrenser
Bruk strukturert håndtering for API-feil og valider inndata på klientsiden for å redusere prøver på nytt.
Vanlige HTTP-svar
| Kode | Mening | Typisk årsak |
|---|---|---|
400 |
Ugyldig forespørsel | Manglende forespørsel, størrelse som ikke støttes, ugyldige modellparametere |
401 |
Uautorisert | Manglende eller ugyldig API nøkkel/økttoken |
402 |
Betaling kreves | Utilstrekkelig kjøpt kreditt eller API tilgangsbegrensning |
403 |
Forbudt | API register-/påloggingsendepunkter er med vilje deaktivert |
404 |
Ikke funnet | Generasjons-ID eies ikke av gjeldende bruker eller endepunktsfeil |
500 |
Serverfeil | Oppstrøms leverandørfeil eller nettverkstidsavbrudd |
Forespørselsgrenser for å håndheve klientsiden
prompt: maksimalt 5000 tegn på enhetlig endepunkt.image_urls: maksimalt 14 nettadresser på enhetlig endepunkt.size: modellspesifikk, valider mot modellmatrise.quality: modellspesifikke verdier for Seedream 5 Lite, Nano Banana 2, Ideogram og Qwen.- API bruk krever kjøpte kreditter; velkomstkreditter er kun for nettsider.
Prøv strategi på nytt
Anbefalt produksjonsatferd:
- Ikke prøv på nytt
400,401,402, eller403uten å endre inndata eller autentisering. - Prøv på nytt
500med eksponentiell backoff og idempotenstasting i applaget ditt. - Sluttpunkt for avstemningsstatus før du starter dupliserte generasjonsjobber.