Developer guide
Villukota
Handfaring og reglur fyri nýroynd eftir støðukotu
Hendan síðan savnar støðukoturnar, sum gáttin gevur aftur, og týdning teirra, umframt handfaringina fyri hvørja kotu.
Um upstream gevur eina 4xx·5xx-kotu, verður hon latin víðari óbroytt, og í øðrum førum verður talvan niðanfyri fylgd.
Eisini eru lýst sniðið á villuboðunum í báðum samvirkisreglunum, reglurnar fyri Anthropic-samvirkis error.type og konsolskíggin, har mark og nýtsla verða kannað.
Støðukota
| Kota | Týðing | Handfaring |
|---|---|---|
| 400 | Feilur í umbønargildum. limit í Anthropic-samvirkis modelllistanum er uttan fyri 1~1000, ella roynt verður at halda fram við einari goymdari svari við GET /responses/{responseId}?stream=true | Rætta gildini, so tey eru innan fyri markið. Les goymda svarið uttan stream. |
| 401 | Eingin lykil, ella lykilurin er útgingin ella tikin aftur | Kanna støðuna á lyklinum á API-lykilsíðuni, og eftirkanna heitnið á headerinum og Bearer-forskeytið. |
| 403 | Eingin atgongd til modellið, nýtslumarkið er rokkið, ov lítið kredit, ella tú ert ikki eigari av voice | error.message greiðir frá orsøkinni. Tølini síggjast á skíggjanum í partinum um at kanna mark og nýtslu niðanfyri. |
| 404 | Modellið finst ikki ella er ikki atkomuligt við hesum lyklinum (íroknað modell, sum ikki longur verða stuðlað), leiðin finst ikki, ella CleviDrive-framleiðslan er eldri enn 3 dagar | Kanna fyrst listan yvir modell, sum kunnu kallast, við GET /models. Samanber leiðina við talvuna á síðuni API-kalling. |
| 408 · 409 · 413 | Tíðarfreist hjá upstream, trengsli ella umbønin er ov stór. Tíðarfreistin fyri voice- og voice-leiðir er 5 minuttir, og markið fyri umbønir er 28 MiB | Um Retry-After er í 409, bíðið ta ávísa tíðina. Við 413 verður umbønin býtt sundur. |
| 429 | Tá upstream-veitarin setur ferðmark | Um Retry-After verður givið, fylg tí óbroytt; annars royn aftur við eksponentiellum bíðitíðarbakka. |
| 5xx | Fyribils villa hjá gáttini ella upstream (íroknað 503) | Royn aftur við eksponentiellum bíðitíðarbakka. Um trupulleikin endurtekur seg, boða frá honum í hjálpini og við at venda tær til okkara, saman við X-Request-Id. |
Nýroynd
Gáttin býr ikki sjálv til 429, og hon roynir ikki aftur ella leggur upstream-svar í bíðirøð í loyndum.
Bíðing og nýroynd verða gjørd av klientinum.
| Kota | Bíðitíð | Síðani |
|---|---|---|
| 409 | Um Retry-After er til staðar, bíð tann tíðina | Send somu umbønina aftur. |
| 429 | Um Retry-After er til staðar, bíð tann tíðina; annars eksponentielt bakkoff | Send somu umbønina aftur. |
| 5xx | Eksponentielt bakkoff | Um tað endurtekur seg, set teg í samband. |
| 413 | Einki bíð | Být umbønina sundur. |
Villukroppur
Villukroppurin hevur ymiska snið alt eftir standardinum. Upstream-villur verða ruddaðar og miðlaðar víðari við einans boðunum; stakkar ella innanhýsis feløg verða ikki send víðari.
Hetta er kroppurin í OpenAI-samsvarandi leiðini.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Hetta er kroppurin í Anthropic-samsvarandi leiðini. error.type verður ásett út frá støðukotuni.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Støðukota | 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 |
| Aðrar kotur | api_error |
Kanna mørk og nýtslu
Mørkini eru ymisk fyri hvørt arbeiðsrúm. Kanna orsøkina til 403 í error.message og síggj síðani tølini á skermunum niðanfyri.
| Tað, sum skal kannast | Konsolskermur |
|---|---|
| Mørkini, sum galda fyri mítt arbeiðsrúm | Útlutað nýtslumark í yvirlitinum |
| Økið og eftirstøðan, sum ætlanin loyvir | Ætlan og kredittir |
| Verulig nýtsla (kall eftir leisti og lykli, væntaðir frádrignir kredittir) | Nýtsla |
| Lyklastøða (um hann er útrunnin ella ógildaður) | API-lyklur |