Fouten

HTTP-foutcodes, antwoordformaten en regels voor opnieuw proberen.

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.

Fouten na streamheaders

SSE kan mislukken nadat HTTP200 al is verzonden. Het antwoord bevat dan een protocolcompatibele foutgebeurtenis; de gateway-verzoekgeschiedenis registreert de terminalstoring onafhankelijk van de draadstatus. Onbekende upstream-berichten worden standaard verborgen, goedgekeurde berichten kunnen openbaar worden gemaakt door beheerdersbeleid en de volledige blootstelling aan upstream-fouten is expliciet. Interne upstream-metagegevens en tijdelijke onbewerkte gegevens blijven alleen voor de beheerder. Ontbrekend gebruik na een onderbroken stream is onbekend/controle vereist, geen automatische schatting op basis van draadbytes. Bewaar de aanvraag-ID en probeer het alleen opnieuw nadat de gedeeltelijke uitvoer is gecontroleerd.