Hopp til innholdet

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, eller 403 uten å endre inndata eller autentisering.
  • Prøv på nytt 500 med eksponentiell backoff og idempotenstasting i applaget ditt.
  • Sluttpunkt for avstemningsstatus før du starter dupliserte generasjonsjobber.