Developer guide
Villukóðar
Meðhöndlun og reglur um endurtekningu eftir stöðukóða
Þessi síða tekur saman stöðukóða sem gáttin skilar, merkingu þeirra og viðbrögð við hverjum kóða.
Ef upstream skilar 4xx·5xx er kóðinn sendur áfram óbreyttur; í öðrum tilvikum gildir taflan hér að neðan.
Einnig er farið yfir form villusvara í báðum samhæfðu sniðunum, reglur um Anthropic-samhæfða error.type og stjórnborðsskjáinn þar sem hægt er að skoða takmörk og notkun.
Stöðukóði
| Kóði | Merking | Viðbrögð |
|---|---|---|
| 400 | Villa í beiðnigildum. limit í lista yfir Anthropic-samhæfð líkön er utan bilsins 1–1000, eða reynt er að halda áfram með vistað svar með GET /responses/{responseId}?stream=true | Leiðréttið gildið þannig að það sé innan bilsins. Skoðið vistuð svör án stream. |
| 401 | Lykil vantar eða lykillinn er útrunninn eða afturkallaður | Athugið stöðu lykils á API-lykilsíðunni og yfirfarið heiti hausins og Bearer-forskeytið. |
| 403 | Enginn aðgangur að líkaninu, notkunarmörkum náð, inneign ófullnægjandi eða notandi er ekki eigandi raddarinnar | error.message greinir á milli ástæðnanna. Skoðið tölurnar á skjánum í hlutanum um athugun á takmörkum og notkun hér að neðan. |
| 404 | Líkan finnst ekki eða er ekki aðgengilegt með þessum lykli (þar með talið líkön sem ekki eru lengur studd), slóð finnst ekki eða CleviDrive-úttak er eldra en 3 daga varðveislutímabilið | Athugið fyrst listann yfir líkön sem hægt er að kalla á með GET /models. Berið slóðina saman við töfluna á síðunni „API-köll“. |
| 408 · 409 · 413 | Tímamörk hjá upstream, mikið álag eða beiðnin er of stór. Fyrir radd- og voice-slóðir eru tímamörkin 5 mínútur og hámarksstærð beiðni 28 MiB | Ef Retry-After fylgir 409 skaltu bíða þann tíma. Skiptið 413-beiðnum upp. |
| 429 | Upstream-veitandi hefur sett hraðatakmörkun | Fylgið Retry-After ef það fylgir; annars skal reyna aftur með veldisvaxandi bið. |
| 5xx | Tímabundin villa í gátt eða hjá upstream (þar með talið 503) | Reynið aftur með veldisvaxandi bið. Ef vandamálið endurtekur sig skaltu láta okkur vita í hjálparmiðstöðinni og í fyrirspurn ásamt X-Request-Id. |
Endurtekning
Gáttin býr ekki til eigin 429-svör og reynir hvorki sjálfkrafa aftur á upstream-svör né setur þau í biðröð.
Bið og endurtekning er á ábyrgð biðlarans.
| Kóði | Biðtími | Næsta skref |
|---|---|---|
| 409 | Ef Retry-After er til staðar, bíðið þann tíma | Sendið sömu beiðni aftur. |
| 429 | Ef Retry-After er til staðar, bíðið þann tíma; annars notið veldisvísislegt bakoff | Sendið sömu beiðni aftur. |
| 5xx | Veldisvísislegt bakoff | Hafið samband ef þetta endurtekur sig. |
| 413 | Engin bið | Skiptið beiðninni upp. |
Villumeginmál
Villumeginmál eru ólík eftir forskrift. Villur frá uppstreymisþjónustu eru hreinsaðar og aðeins skilaboðin send áfram; staflar og innri reitir eru ekki sendir áfram.
Þetta er meginmál OpenAI-samhæfðu leiðarinnar.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Þetta er meginmál Anthropic-samhæfðu leiðarinnar. error.type er ákvarðað út frá stöðukóðanum.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Stöðukóði | 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ðrir kóðar | api_error |
Athugun á mörkum og notkun
Mörkin eru mismunandi eftir vinnusvæðum. Athugið ástæðu 403 í error.message og skoðið síðan gildin á skjánum hér að neðan.
| Atriði til að athuga | Stjórnborðsskjár |
|---|---|
| Mörk sem gilda fyrir vinnusvæðið mitt | Úthlutuð notkunarmörk í yfirlitinu |
| Svið og staða sem áskriftin leyfir | Áskrift og inneign |
| Raunveruleg notkun (fjöldi beiðna eftir módeli og lykli, áætlaðar inneignir sem dragast frá) | Notkun |
| Staða lykils (hvort hann sé útrunninn eða afturkallaður) | API-lykill |