Foutcodes: 401, 402, 403, 429 en meer
Wat elke fout van de API betekent, en wat je eraan doet.
Elke fout heeft een melding en een code die je in je code kunt nakijken. Elk antwoord, fout of niet, heeft een kop x-request-id: stuur die mee als je contact opneemt met support.
- 400 · Ongeldig verzoek
- Het verzoek klopt niet. De body is geen JSON (
invalid_json),modelontbreekt (missing_model), het model ondersteunt dit endpoint niet (unsupported_endpoint; de melding zegt welk wel), of het model weigerde een parameter (invalid_request, soms met status422). Pas het verzoek aan; opnieuw proberen helpt niet. - 401 · Niet ingelogd
- Geen key (
missing_api_key), een verkeerde of ingetrokken key (invalid_api_key), of een verlopen key (api_key_expired). StuurAuthorization: Bearer nr-v1-…mee en kijk de key na op app.nexrouting.com/keys. - 402 · Betaling nodig
- Je saldo is op of te laag voor de prompt die je stuurde (
insufficient_credits), of de key heeft zijn budget bereikt (key_budget_exceeded). Waardeer op of verhoog het budget van de key. - 403 · Niet toegestaan
- De key mag dit model niet gebruiken (
model_not_allowed): kijk de toegestane modellen na. Of het account staat op pauze (account_suspended): neem contact op met support. - 404 · Niet gevonden
- Het model bestaat niet of is nu niet beschikbaar (
model_not_found); de melding noemt vaak een ander. Of het endpoint bestaat niet (not_found): de base URL moet eindigen op/v1. - 413 · Te groot
- De body is groter dan 32 MB, of te groot voor het model (
request_too_large). - 429 · Te veel verzoeken
- Je key ging over zijn aantal verzoeken per minuut, of het model is nu druk (
rate_limit_exceeded). Wacht het aantal seconden uit de kopRetry-Afteren probeer het opnieuw. Zie Limieten per minuut. - 500 · Interne fout
- Er ging iets mis bij ons (
internal_error). Probeer het opnieuw. Blijft het gebeuren, neem dan contact op met support en noem het verzoek-ID. - 503 · Niet beschikbaar
- Het model is even niet beschikbaar (
model_unavailable). Probeer het zo opnieuw, of gebruik een ander model of de andere lane.
Alleen in je verbruik
Twee statuscodes zie je alleen in je verbruik: 499 betekent dat je app de verbinding sloot voordat het antwoord compleet was, en 502 dat een gestreamd antwoord onderweg afbrak.
Vorm van een fout
Fouten hebben de vorm van OpenAI:
{"error": {"message": "Invalid API key.", "type": "authentication_error", "param": null, "code": "invalid_api_key"}}Op /v1/messages hebben fouten de vorm van Anthropic, met een type en een message maar zonder code:
{"type": "error", "error": {"type": "authentication_error", "message": "Invalid API key."}}De meldingen zelf zijn in het Engels.