UlazAI udviklerdokumenter
Fejl og grænser
Fejlhåndtering og platformsgrænser
Brug struktureret håndtering af API-fejl og valider input på klientsiden for at reducere forsøger igen.
Almindelige HTTP-svar
| Kode | Betydning | Typisk årsag |
|---|---|---|
400 |
Ugyldig anmodning | Manglende prompt, ikke-understøttet størrelse, ugyldige modelparametre |
401 |
Uautoriseret | Manglende eller ugyldig API nøgle/sessionstoken |
402 |
Betaling påkrævet | Utilstrækkelige købte kreditter eller API adgangsbegrænsning |
403 |
Forbudt | API register/login slutpunkter er bevidst deaktiveret |
404 |
Ikke fundet | Generations-id ejes ikke af den nuværende bruger eller endepunktsmismatch |
500 |
Serverfejl | Upstream-udbyderfejl eller netværkstimeout |
Anmodningsgrænser for at håndhæve klientsiden
prompt: maksimalt 5000 tegn på unified endpoint.image_urls: maksimalt 14 URL'er på unified endpoint.size: modelspecifik, valider imod model matrix.quality: modelspecifikke værdier for Seedream 5 Lite, Nano Banana 2, Ideogram og Qwen.- Brug af API kræver købte kreditter; velkomstkreditter er kun på webstedet.
Prøv strategi igen
Anbefalet produktionsadfærd:
- Forsøg ikke igen
400,401,402, eller403uden at ændre input eller godkendelse. - Prøv igen
500med eksponentiel backoff og idempotenstastning i dit applag. - Afstemningsstatusslutpunkt før lancering af duplikerede generationsjob.