Dokumenty pro vývojáře UlazAI
Chyby a limity
Zpracování chyb a limity platformy
Použijte strukturované zpracování pro chyby API a ověřte vstupy na straně klienta, abyste je snížili zopakuje.
Běžné odpovědi HTTP
| kód | Význam | Typická příčina |
|---|---|---|
400 |
Neplatný požadavek | Chybí prompt, nepodporovaná velikost, neplatné parametry modelu |
401 |
Neoprávněný | Chybějící nebo neplatný klíč/token relace API |
402 |
Je vyžadována platba | Nedostatek zakoupených kreditů nebo omezení přístupu API |
403 |
Zakázáno | Koncové body registru/přihlášení API jsou záměrně zakázány |
404 |
Nenalezeno | ID generace nevlastní aktuální uživatel nebo neshoda koncového bodu |
500 |
Chyba serveru | Selhání poskytovatele upstream nebo časový limit sítě |
Požadujte limity k vynucení na straně klienta
prompt: maximálně 5000 znaků na sjednoceném koncovém bodu.image_urls: maximálně 14 adres URL na sjednoceném koncovém bodu.size: specifické pro model, ověření proti modelová matice.quality: hodnoty specifické pro model pro Seedream 5 Lite, Nano Banana 2, Ideogram a Qwen.- Použití API vyžaduje zakoupené kredity; uvítací kredity jsou pouze pro webové stránky.
Zkuste znovu strategii
Doporučené produkční chování:
- Nezkoušejte to znovu
400,401,402nebo403bez změny vstupu nebo autorizace. - Zkuste to znovu
500s exponenciálním backoffem a idempotency klíčováním ve vrstvě aplikace. - Koncový bod stavu dotazování před spuštěním duplicitních úloh generování.