Fouten
HTTP-foutcodes, antwoordformaten en regels voor opnieuw proberen.
Fouten
| HTTP | Betekenis | Aanbevolen actie |
|---|---|---|
| 400 | Ongeldig verzoek | Corrigeer JSON en verplichte velden |
| 401 | Ongeldige, bevroren of ingetrokken sleutel | Draai de sleutel of maak deze los |
| 402 | Onvoldoende accountsaldo of sleutelgebruikslimiet bereikt | Voeg geld toe of reset/verhoog de sleutellimiet |
| 403 | Model niet beschikbaar voor de sleutel of het bron-IP-adres dat is afgewezen door een API-toelatingslijst | Update sleutelmachtigingen of gebruik een toegestaan bron-IP-adres |
| 404 | Onbekend eindpunt, model of asynchrone aanvraag | Controleer de ID en het pad |
| 413 | Verzoek te groot | Verklein de contextgrootte |
| 429 | RPM of gelijktijdigheid overschreden | Eer Retry-After |
| 500 | Gateway-fout | Probeer het opnieuw en inspecteer de logboeken |
| 502/503/504 | Upstream niet beschikbaar of time-out | Probeer het opnieuw met exponentieel uitstel |
Betaling vereist
Onvoldoende bedrijfs-/accountsaldo retourneert HTTP 402 Payment Required in de OpenAI-compatibele envelop:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}
Dezelfde stabiele reden/code wordt vastgelegd in de aanvraaggeschiedenis. A 402 Het verzoek wordt afgewezen vóór uitvoering door de aanbieder en mag niet automatisch opnieuw worden geprobeerd totdat de financiering of de toepasselijke bestedingsbeperking is gecorrigeerd.
Afwijzing van IP-toelatingslijst
Wanneer een geverifieerde API-sleutel geldig is, maar het bronadres buiten de effectieve API-toelatingslijst voor persoonlijke of zakelijke organisaties staat, wijst Model Gate het verzoek af voordat het upstream wordt uitgevoerd. OpenAI-compatibele reacties gebruiken HTTP 403 met code ip_not_allowed. Antropisch-compatibele antwoorden gebruiken de Antropische foutenvelop met HTTP 403 En authentication_error. Probeer het niet opnieuw vanaf dezelfde niet-toegestane bron; wijzig de geconfigureerde toelatingslijst of stuur het verzoek vanaf een toegestaan adres.
Opnieuw proberen 429 na Retry-After. Opnieuw proberen 500, 502, 503, En 504 tot drie keer met een uitstel van 1/2/4 seconde. Probeer niet automatisch opnieuw validatie-, authenticatie-, saldo- of niet-gevonden fouten.
Gebruik de openbare ID van het verzoek X-Request-ID om de reactie te correleren met de verzoek log.