Hibák

HTTP	Jelentése	Javasolt intézkedés
400	Érvénytelen kérés	Javítsa ki a JSON-t és a kötelező mezőket
401	Érvénytelen, lefagyott vagy visszavont kulcs	Forgassa el vagy oldja fel a kulcsot
402	Elégtelen számlaegyenleg vagy kulcshasználati korlát	Tegyen hozzá pénzt, vagy állítsa vissza/növelje a kulcskorlátot
403	A modell nem érhető el az API engedélyezési listája által elutasított kulcshoz vagy forrás IP-címhez	Frissítse a kulcsengedélyeket, vagy használjon engedélyezett forrás IP-címet
404	Ismeretlen végpont, modell vagy aszinkron kérés	Ellenőrizze az azonosítót és az elérési utat
413	A kérés túl nagy	Csökkentse a kontextus méretét
429	Az RPM vagy az egyidejűség túllépve	Becsület Retry-After
500	Átjáró hiba	Próbálja újra, és ellenőrizze a naplókat
502/503/504	Az upstream nem érhető el, vagy túllépte az időt	Próbálja újra exponenciális visszalépéssel

Fizetés szükséges

Nem elegendő cég/számlaegyenleg HTTP-t ad vissza 402 Payment Required az OpenAI-kompatibilis borítékban:

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

Ugyanez a stabil ok/kód kerül rögzítésre a Kéréstörténetben. A 402 A kérést a szolgáltató végrehajtása előtt elutasítják, és nem szabad automatikusan újra megkísérelni mindaddig, amíg a finanszírozást vagy a vonatkozó kiadási korlátot ki nem javították.

IP engedélyezési lista elutasítása

Ha egy hitelesített API-kulcs érvényes, de a forráscím kívül esik a hatályos személyes vagy üzleti szervezet API-engedélyezőlistáján, a Model Gate elutasítja a kérést az upstream végrehajtás előtt. Az OpenAI-kompatibilis válaszok HTTP-t használnak 403 kóddal ip_not_allowed. Az antropikus kompatibilis válaszok az Antropikus hibaborítékot használják a HTTP-vel 403 és authentication_error. Ne próbálkozzon újra ugyanabból a nem engedélyezett forrásból; módosítsa a konfigurált engedélyezési listát, vagy küldje el a kérést egy engedélyezett címről.

Próbálja újra 429 után Retry-After. Próbálja újra 500, 502, 503, és 504 akár háromszor 1/2/4 másodperces visszalépéssel. Ne próbálja meg automatikusan újra az érvényesítést, hitelesítést, egyenleget vagy nem található hibákat.

Használja a kérés nyilvános azonosítóját X-Request-ID hogy a választ korrelálja a kérésnapló.