Developer guide
Flaterkoades
Hanneljen en regels foar opnij besykjen per statuskoade
Op dizze side wurde de statuskoades dy't de gateway weromjout en har betsjutting gearfette, mei de passende aksje per koade.
As de upstream 4xx·5xx weromjout, wurdt dy koade ûnferoare trochjûn. Yn oare gefallen jildt de tabel hjirûnder.
Ek wurde de foarmen fan flaterteksten foar de twa kompatibiliteitsformaten, de regels foar Anthropic-kompatibele error.type en it konsoleskerm foar it kontrolearjen fan limiten en gebrûk beskreaun.
Statuskoade
| Koade | Betsjutting | Aksje |
|---|---|---|
| 400 | Flater yn de oanfraachwearden. De limit fan de Anthropic-kompatibele modellist falt bûten 1~1000, of der is besocht in bewarre antwurd op te heljen mei GET /responses/{responseId}?stream=true | Pas de wearde oan sadat dy binnen it berik falt. Helje bewarre antwurden op sûnder stream. |
| 401 | Gjin kaai, of in ferrûne of ynlutsen kaai | Kontrolearje de kaaitastân op it API-kaaiskerm en kontrolearje de kopnamme en it Bearer-foarheaksel. |
| 403 | Gjin tagongsrjocht ta it model, gebrûkslimyt oerskreaun, te min credits, of gjin eigner fan 'e stim | error.message makket it ûnderskied tusken de oarsaken. De sifers kinne jo besjen op it skerm yn 'e seksje oer it kontrolearjen fan limiten en gebrûk hjirûnder. |
| 404 | It model bestiet net of is net tagonklik mei dizze kaai (ynklusyf modellen dêr't de stipe foar beëinige is), in net-besteand paad, of in CleviDrive-resultaat wêrfan de bewaringsperioade fan 3 dagen ferrûn is | Kontrolearje earst mei GET /models de list fan modellen dy't oanroppen wurde kinne. Ferlykje it paad mei de tabel op 'e side API oanroppe. |
| 408 · 409 · 413 | Tiidlimyt fan 'e upstream oerskreaun, oerlêst, of oanfraach te grut. Foar audio- en stimpaden is de tiidlimyt 5 minuten en de maksimale oanfraachgrutte 28 MiB | As 409 in Retry-After befettet, wachtsje dan sa lang. Ferdiel in 413-oanfraach yn lytsere dielen. |
| 429 | De upstream-provider hat in snelheidslimyt oplein | Folgje Retry-After as dy oanwêzich is; as dy ûntbrekt, besykje it opnij mei eksponinsjele backoff. |
| 5xx | Tydlike flater fan 'e gateway of de upstream (ynklusyf 503) | Besykje it opnij mei eksponinsjele backoff. As it weromkomt, meld it dan fia Help en Kontakt, tegearre mei X-Request-Id. |
Opnij besykje
De gateway makket gjin eigen 429 en besiket upstream-antwurden ek net stilwei opnij of set se yn in wachtrige.
De kliïnt wachtet en besiket it opnij.
| Koade | Wachttiid | Dêrnei |
|---|---|---|
| 409 | As der Retry-After is: dy tiid | Itselde fersyk opnij ferstjoere. |
| 429 | As der Retry-After is: dy tiid; oars eksponinsjele weromstap | Itselde fersyk opnij ferstjoere. |
| 5xx | Eksponinsjele weromstap | As it him werhellet, nim dan kontakt op. |
| 413 | Gjin wachttiid | Fersyk opdiele. |
Flaterlichem
It flaterlichem hat per spesifikaasje in oare foarm. Upstream-flaters wurde oprêden en trochjûn mei allinnich it berjocht; stack- en ynterne fjilden wurde net trochjûn.
Dit is it lichem fan it OpenAI-kompatibele paad.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Dit is it lichem fan it Anthropic-kompatibele paad. error.type wurdt bepaald troch de statuskoade.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Statuskoade | 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 |
| Oare koades | api_error |
Limiten en gebrûk kontrolearje
De limytwearden ferskille per wurkromte. Kontrolearje de reden foar 403 yn error.message en besjoch dêrnei de wearden op it ûndersteande skerm.
| Wat te kontrolearjen | Konsole-skerm |
|---|---|
| De limyt dy't foar myn wurkromte jildt | Tawiisde gebrûkslimyt yn it oersjoch |
| It berik en saldo dat it plan tastiet | Plan en credits |
| Werklik gebrûk (oproppen per model en kaai, ferwachte ôfskreaune credits) | Gebrûk |
| Kaaisteat (oft ferrûn of ynlutsen) | API-kaai |