Developer guide
Foutkode
Hantering en herprobeerreëls volgens statuskode
Hierdie bladsy som die statuskodes wat deur die gateway teruggestuur word, hul betekenisse en die hantering per kode op.
Wanneer die stroomopdiens ’n 4xx- of 5xx-kode terugstuur, word daardie kode onveranderd deurgegee; in ander gevalle geld die tabel hieronder.
Dit bevat ook die vorm van die foutliggaam vir die twee versoenbare spesifikasies, die reëls vir Anthropic-versoenbare error.type, asook die konsoleskerm waar limiete en gebruik nagegaan kan word.
Statuskode
| Kode | Betekenis | Hantering |
|---|---|---|
| 400 | Ongeldige versoekwaarde. Die limit van die Anthropic-versoenbare modelllys val buite 1–1000, of daar is probeer om ’n gestoorde respons voort te sit met GET /responses/{responseId}?stream=true | Stel die waarde binne die reeks. Haal gestoorde response sonder stream op. |
| 401 | Geen sleutel, of ’n sleutel wat verval of herroep is | Gaan die sleutelstatus op die API-sleutelblad na en kontroleer die kopskrifnaam en die Bearer-voorvoegsel. |
| 403 | Geen toegangsreg tot die model nie, gebruikslimiet oorskry, onvoldoende krediete, of nie die eienaar van die stem nie | error.message onderskei die rede. Sien die syfers op die skerm in die afdeling hieronder oor limiete en gebruik. |
| 404 | Die model bestaan nie of is nie met hierdie sleutel toeganklik nie (insluitend modelle waarvan ondersteuning beëindig is), die pad bestaan nie, of ’n CleviDrive-uitset waarvan die bewaringstydperk van 3 dae verstryk het | Gaan eers die lys modelle wat met GET /models opgeroep kan word, na. Vergelyk die pad met die tabel op die API-oproepe-bladsy. |
| 408 · 409 · 413 | Stroomoptydverstreke, opeenhoping, of versoekgrootte oorskry. Vir stem- en stemroetes is die tydsbeperking 5 minute en die versoeklimiet 28 MiB | As 409 ’n Retry-After bevat, wag vir daardie tyd. Verdeel versoeke vir 413 op. |
| 429 | Wanneer die stroomopverskaffer ’n tempobeperking toepas | Volg Retry-After onveranderd indien dit gegee word; andersins herprobeer met eksponensiële terugverwagting. |
| 5xx | Tydelike fout by die gateway of stroomopdiens (insluitend 503) | Herprobeer met eksponensiële terugverwagting. Indien dit herhaal, laat weet ons via Hulp en Kontak, saam met X-Request-Id. |
Herprobeer
Die gateway skep nie sy eie 429 nie en herprobeer ook nie stroomopresponse stilweg of plaas dit in ’n tou nie.
Die kliënt hanteer wag en herprobeer.
| Kode | Wagtyd | Daarna |
|---|---|---|
| 409 | Daardie tyd indien Retry-After teenwoordig is | Stuur dieselfde versoek weer. |
| 429 | Daardie tyd indien Retry-After teenwoordig is, anders eksponensiële terugvering | Stuur dieselfde versoek weer. |
| 5xx | Eksponensiële terugvering | Kontak ondersteuning indien dit herhaal. |
| 413 | Geen wagtyd nie | Verdeel die versoek op. |
Foutliggaam
Die vorm van die foutliggaam verskil volgens die spesifikasie. Vir opwaartse foute word slegs die boodskap behou en netjies deurgegee; stapels en interne velde word nie deurgegee nie.
Dit is die liggaam van die OpenAI-versoenbare roete.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Dit is die liggaam van die Anthropic-versoenbare roete. error.type word volgens die statuskode bepaal.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Statuskode | 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 |
| Ander kodes | api_error |
Kontroleer limiete en gebruik
Limietwaardes verskil per werkruimte. Kontroleer die rede vir 403 in error.message en bekyk daarna die waardes op die onderstaande skerm.
| Wat om na te gaan | Konsole-skerm |
|---|---|
| Limiete wat op my werkruimte toegepas word | Toegekende gebruikslimiete in die oorsig |
| Die reeks wat deur die plan toegelaat word en die saldo | Plan en krediete |
| Werklike gebruik (oproepe per model en sleutel, beraamde afgetrekte krediete) | Gebruik |
| Sleutelstatus (of dit verval of herroep is) | API-sleutels |