Erori
Codurile de eroare HTTP, formatele de răspuns și regulile de reîncercare.
| HTTP | Sens | Acțiune recomandată |
|---|---|---|
| 400 | Solicitare nevalidă | JSON corect și câmpurile obligatorii |
| 401 | Cheie nevalidă, blocată sau revocată | Rotiți sau deblocați cheia |
| 402 | Sold insuficient al contului sau limita de utilizare a cheii atinsă | Adăugați fonduri sau resetați/măriți limita cheii |
| 403 | Model indisponibil pentru cheia sau IP-ul sursă respins de o listă de permisiuni API | Actualizați permisiunile cheii sau utilizați un IP sursă permis |
| 404 | Solicitare finală, model sau asincronă necunoscută | Verificați identificatorul și calea |
| 413 | Solicitare prea mare | Reduceți dimensiunea contextului |
| 429 | RPM sau concurența a fost depășită | Onora Retry-After |
| 500 | Eroare de gateway | Reîncercați și inspectați jurnalele |
| 502/503/504 | În amonte indisponibil sau expirat | Reîncercați cu backoff exponențial |
Este necesară plata
Soldul insuficient al companiei/contului returnează HTTP 402 Payment Required în plicul compatibil cu OpenAI:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}Același motiv/cod stabil este înregistrat în Istoricul cererilor. O 402 cererea este respinsă înainte de executarea furnizorului și nu ar trebui să fie reîncercată automat până când finanțarea sau constrângerea de cheltuieli aplicabilă nu a fost corectată.
Respingerea listei permise IP
Când o cheie API autentificată este validă, dar adresa sursă se află în afara listei de permisiuni efective pentru API-ul personal sau al organizației de afaceri, Model Gate respinge cererea înainte de executarea în amonte. Răspunsurile compatibile cu OpenAI folosesc HTTP 403 cu cod ip_not_allowed. Răspunsurile compatibile cu antropice folosesc plicul de eroare antropică cu HTTP 403 şi authentication_error. Nu reîncercați din aceeași sursă interzisă; modificați lista de permis configurată sau trimiteți cererea de la o adresă permisă.
Reîncercați 429 după Retry-After. Reîncercați 500, 502, 503, și 504 de până la trei ori cu retragere de 1/2/4 secundă. Nu reîncercați automat validarea, autentificarea, soldul sau erorile negăsite.
Utilizați ID-ul public solicitat de la X-Request-ID pentru a corela răspunsul cu jurnalul cererilor.
Erori după anteturile fluxului
SSE poate eșua după ce HTTP200 a fost deja trimis. Răspunsul conține apoi un eveniment de eroare compatibil cu protocolul; istoricul cererilor de gateway înregistrează defecțiunea terminalului independent de starea firului. Mesajele necunoscute din amonte sunt ascunse în mod implicit, mesajele aprobate pot fi expuse de politica administratorului, iar expunerea completă a erorilor din amonte este explicită. Metadatele interne din amonte și brutele temporare rămân numai pentru administrator. Utilizarea lipsă după un flux întrerupt este necunoscută/necesită revizuire, nu o estimare automată din octeți de conexiuni. Păstrați ID-ul cererii și reîncercați numai deliberat după verificarea ieșirii parțiale.