Developer guide
Felkod
Åtgärder och regler för nya försök per statuskod
Gatewayen vidarebefordrar uppströmskodens 4xx- och 5xx-svar oförändrade. I övriga fall följer den reglerna i tabellen nedan.
400, 401, 403, 404 och 413 är koder som kräver att begäran eller konfigurationen korrigeras, medan 409, 429 och 5xx är koder som innebär att klienten ska vänta och sedan skicka samma begäran igen.
Formatet för felmeddelandet varierar mellan specifikationer, och error.type i den Anthropic-kompatibla sökvägen bestäms av statuskoden.
Orsaken till 403 särskiljs med error.message, och gränsvärden och användningssiffror kontrolleras i konsolen.
Statuskod
| Kod | Betydelse | Åtgärd |
|---|---|---|
| 400 | Begäransvärdet är ogiltigt. limit för listan över Anthropic-kompatibla modeller ligger utanför 1–1000, eller så försökte du återuppta strömningen av ett sparat svar med GET /responses/{responseId}?stream=true. | Korrigera värdet så att det ligger inom intervallet. Hämta sparade svar utan stream. |
| 401 | Nyckeln saknas eller har gått ut eller återkallats. | Kontrollera nyckelstatusen på API-nyckelsidan och kontrollera rubriknamnet samt Bearer-prefixet. |
| 403 | Du saknar åtkomstbehörighet till modellen, har överskridit användningsgränsen, har för få krediter eller äger inte rösten. | Kontrollera orsaken med error.message och kontrollera värdena på skärmen i avsnittet om gränser och användning nedan. |
| 404 | Modellen finns inte eller kan inte nås med denna nyckel (inklusive modeller som inte längre stöds). Detta returneras även när du anropar en sökväg som inte finns eller begär ett CleviDrive-resultat vars lagringsperiod på 3 dagar har löpt ut. | Kontrollera först listan över modeller som kan anropas med GET /models. Jämför sökvägen med tabellen på sidan API-anrop. |
| 408 · 409 · 413 | Tidsgränsen för uppströmsanslutningen har överskridits, det råder överbelastning eller så är begäran för stor. Tidsgränsen för röst- och voice-sökvägar är 5 minuter och gränsen för begärans storlek är 28 MiB. | Om 409 innehåller Retry-After väntar du den angivna tiden och skickar sedan samma begäran igen. Dela upp begäran vid 413. |
| 429 | Den uppströmsliggande leverantören har tillämpat en hastighetsbegränsning. | Om Retry-After finns väntar du den angivna tiden och försöker igen. Om det saknas försöker du igen med exponentiell backoff. |
| 5xx | Ett tillfälligt fel i gatewayen eller hos den uppströmsliggande tjänsten (inklusive 503). | Försök igen med exponentiell backoff. Kontakta oss om problemet kvarstår. |
402 returneras inte. Både otillräckliga krediter och överskriden användningsgräns returneras som 403.
Försök igen och kontakta oss
Gatewayen skapar inte egna 429-fel och försöker inte igen eller köar uppströmsliggande svar åt dig. Klienten ansvarar för att vänta och försöka igen.
När du kontaktar oss ska du ange X-Request-Id via Hjälp och kontakta oss. Om du inte skickade X-Request-Id finns det servergenererade värdet i request-id-huvudet i det Anthropic-kompatibla svaret.
Felkropp
Formatet på feltexten varierar beroende på specifikation. Uppströmsfel rensas och vidarebefordras med endast meddelandet; stacken eller interna fält vidarebefordras inte.
Feltext för den OpenAI-kompatibla sökvägen.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Feltext för den Anthropic-kompatibla sökvägen. error.type fastställs enligt statuskoden, som visas i tabellen nedan.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Statuskod | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Övriga koder | api_error |
Kontrollera gränser och användning
Gränsvärdena varierar mellan arbetsytor. Kontrollera orsaken till 403 i error.message och kontrollera sedan värdena på följande skärm.
| Att kontrollera | Konsolvy |
|---|---|
| Gräns som gäller för arbetsytan | Tilldelad användningsgräns i översikten |
| Omfattning och saldo som planen tillåter | Plan och krediter |
| Faktisk användning (anrop per modell och nyckel, beräknade krediter som dras av) | Användning |
| Nyckelstatus (om nyckeln har löpt ut eller återkallats) | API-nyckel |