Ugrás a tartalomra

UlazAI fejlesztői dokumentumok

Hibák és korlátok

Hibakezelés és platformkorlátok

Használjon strukturált kezelést a API hibákhoz, és ellenőrizze a bemeneteket a kliens oldalon, hogy csökkentse újrapróbálkozik.

Gyakori HTTP-válaszok

kód Jelentése Tipikus ok
400 Érvénytelen kérés Hiányzó prompt, nem támogatott méret, érvénytelen modellparaméterek
401 Jogosulatlan Hiányzó vagy érvénytelen API kulcs/munkamenet token
402 Fizetés szükséges Nincs elég vásárolt kredit vagy API hozzáférési korlátozás
403 Tilos A API regiszter/bejelentkezési végpontok szándékosan le vannak tiltva
404 Nem található A generációs azonosító nem az aktuális felhasználó tulajdonában van, vagy a végpont nem egyezik
500 Szerver hiba Felfelé irányuló szolgáltatói hiba vagy hálózati időtúllépés

Kérjen korlátokat az ügyféloldali érvényesítéshez

  • prompt: maximum 5000 karakter az egyesített végponton.
  • image_urls: legfeljebb 14 URL az egyesített végponton.
  • size: modellspecifikus, ellenőrzi modell mátrix.
  • quality: modellspecifikus értékek Seedream 5 Lite, Nano Banana 2, Ideogram és Qwen esetén.
  • A API használatához vásárolt kreditekre van szükség; az üdvözlő kreditek csak a webhelyre vonatkoznak.

Próbálja újra a stratégiát

Javasolt gyártási viselkedés:

  • Ne próbálja újra 400, 401, 402, vagy 403 a bemenet vagy a hitelesítés megváltoztatása nélkül.
  • Próbálja újra 500 exponenciális visszalépéssel és idempotencia kulcsszóval az alkalmazásrétegben.
  • Lekérdezés állapota végpont duplikált generálási feladatok indítása előtt.