Developer guide

Feilkoder

Tiltak og regler for nytt forsøk per statuskode

Denne siden oppsummerer statuskodene som returneres av gatewayen, hva de betyr, og tiltak per kode.
Når upstream returnerer 4xx·5xx, videresendes koden uendret. I andre tilfeller gjelder tabellen nedenfor.
Den beskriver også formatet på feilteksten for de to kompatibilitetsstandardene, reglene for Anthropic-kompatibel error.type og konsollbildet for kontroll av grenser og bruk.

Statuskode

KodeBetydningTiltak
400Feil i forespørselsverdien. limit i listen over Anthropic-kompatible modeller er utenfor 1~1000, eller et lagret svar forsøkes hentet videre med GET /responses/{responseId}?stream=trueKorriger verdien slik at den er innenfor området. Hent lagrede svar uten stream.
401Nøkkel mangler eller er utløpt eller tilbakekaltKontroller nøkkelstatusen på API-nøkkelsiden, og sjekk headernavnet og Bearer-prefikset.
403Ingen tilgang til modellen, bruksgrensen er overskredet, utilstrekkelig kreditt eller du er ikke eieren av stemmenerror.message angir årsaken. Du finner tallene på skjermbildet i delen nedenfor om kontroll av grenser og bruk.
404Modellen finnes ikke eller er ikke tilgjengelig med denne nøkkelen (inkludert modeller som ikke lenger støttes), banen finnes ikke, eller et CleviDrive-resultat har overskredet oppbevaringsperioden på 3 dagerKontroller først listen over modeller som kan kalles, med GET /models. Sammenlign banen med tabellen på siden for API-kall.
408 · 409 · 413Tidsavbrudd hos upstream, overbelastning eller forespørselen er for stor. Tidsgrensen for tale- og stemmebaner er 5 minutter, og øvre grense for forespørsler er 28 MiBHvis 409 har Retry-After, venter du så lenge. Del opp forespørselen ved 413.
429Når upstream-leverandøren har innført en hastighetsbegrensningFølg Retry-After hvis den finnes. Hvis ikke, gjør du et nytt forsøk med eksponentiell tilbakekobling.
5xxMidlertidig feil i gatewayen eller hos upstream (inkludert 503)Gjør et nytt forsøk med eksponentiell tilbakekobling. Hvis det gjentar seg, kan du melde fra via hjelpesidene og kontaktskjemaet, og ta med X-Request-Id.

Nytt forsøk

Gatewayen oppretter ikke egne 429-svar og prøver heller ikke automatisk på nytt eller legger upstream-svar i kø.
Klienten håndterer venting og nye forsøk.

KodeVentetidDeretter
409Hvis Retry-After finnes, venter du så lengeSender samme forespørsel på nytt.
429Hvis Retry-After finnes, venter du så lenge; ellers bruker du eksponentiell tilbakekoblingSender samme forespørsel på nytt.
5xxEksponentiell tilbakekoblingKontakter kundestøtte hvis det gjentar seg.
413Ingen ventingDeler opp forespørselen.

Feilinnhold

Feilinnholdet har ulik struktur avhengig av spesifikasjonen. Oppstrømsfeil videresendes ryddet opp med bare meldingen; stakk og interne felt blir ikke sendt videre.

Dette er innholdet for den OpenAI-kompatible banen.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Dette er innholdet for den Anthropic-kompatible banen. error.type bestemmes av statuskoden.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
Anthropic-kompatibel error.type
Statuskodeerror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Andre koderapi_error

Kontrollere grenser og forbruk

Grenseverdiene varierer fra arbeidsområde til arbeidsområde. Kontroller årsaken til 403 i error.message, og se deretter verdiene på skjermbildene nedenfor.

Det som skal kontrolleresKonsollskjerm
Grensen som gjelder for arbeidsområdet mittTildelt bruksgrense i oversikten
Området planen tillater, og saldoenPlan og kreditter
Faktisk forbruk (antall kall per modell og nøkkel, forventede fratrukne kreditter)Forbruk
Nøkkelstatus (om den er utløpt eller tilbakekalt)API-nøkler
CLEVI

Språk og region

Maskinoversatte språk er merket. Tilgjengeligheten følger den publiserte nettstedspakken.

136 språk

Anbefalt

1

Øst-Asia

7

Sørøst-Asia

11

Sør-Asia

18

Sentral-Asia

5

Midtøsten og Kaukasus

10

Vest-Europa og Sør-Europa

16

Storbritannia og Irland

4

Nord-Europa

10

Sentral-Europa og Balkan

14

Øst-Europa

5

Øst-Afrika

8

Vest-Afrika og Sentral-Afrika

9

Sørlige Afrika

8

Amerika

5

Oseania

5