Feil
HTTP-feilkoder, svarformater og regler for forsøk på nytt.
Feil
| HTTP | Betydning | Anbefalt handling |
|---|---|---|
| 400 | Ugyldig forespørsel | Korriger JSON og obligatoriske felt |
| 401 | Ugyldig, frosset eller tilbakekalt nøkkel | Roter eller frigjør nøkkelen |
| 402 | Utilstrekkelig kontosaldo eller grense for nøkkelbruk er nådd | Legg til midler eller tilbakestill/øk nøkkelgrensen |
| 403 | Modellen er utilgjengelig for nøkkelen eller kilde-IP-en som er avvist av en API-godkjenningsliste | Oppdater nøkkeltillatelser eller bruk en tillatt kilde-IP |
| 404 | Ukjent endepunkt, modell eller asynkronforespørsel | Sjekk identifikatoren og banen |
| 413 | Forespørselen er for stor | Reduser kontekststørrelsen |
| 429 | RPM eller samtidighet overskredet | Ære Retry-After |
| 500 | Gateway-feil | Prøv på nytt og inspiser logger |
| 502/503/504 | Oppstrøms utilgjengelig eller tidsavbrutt | Prøv på nytt med eksponentiell backoff |
Betaling kreves
Utilstrekkelig selskap/kontosaldo returnerer HTTP 402 Payment Required i den OpenAI-kompatible konvolutten:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}
Den samme stabile årsaken/koden er registrert i Forespørselshistorikk. EN 402 Forespørselen avvises før leverandøren utføres og bør ikke prøves automatisk på nytt før finansiering eller gjeldende utgiftsbegrensning er korrigert.
Avvisning av IP-godkjenningsliste
Når en autentisert API-nøkkel er gyldig, men kildeadressen er utenfor den effektive personlige eller forretningsorganisasjons API-godkjenningslisten, avviser Model Gate forespørselen før oppstrøms utførelse. OpenAI-kompatible svar bruker HTTP 403 med kode ip_not_allowed. Antropisk-kompatible svar bruker Antropisk feilkonvolutt med HTTP 403 og authentication_error. Ikke prøv på nytt fra den samme ikke-tillatte kilden; endre den konfigurerte godkjenningslisten eller send forespørselen fra en tillatt adresse.
Prøv på nytt 429 etter Retry-After. Prøv på nytt 500, 502, 503, og 504 opptil tre ganger med 1/2/4-sekunds backoff. Ikke prøv automatisk validering, autentisering, balanse eller feil som ikke ble funnet.
Bruk forespørselen offentlig ID fra X-Request-ID å korrelere responsen med forespørselslogg.