Developer guide
Veakoodid
Toimingud ja korduskatsete reeglid olekukoodide kaupa
Sellel lehel on kokku võetud lüüsi tagastatavad olekukoodid ja nende tähendused ning koodipõhised toimingud.
Kui ülesvooluteenuse vastus on 4xx·5xx, edastatakse kood muutmata kujul; muudel juhtudel järgitakse allolevat tabelit.
Samuti on kirjeldatud kahe ühilduvusstandardi veekeha vormingut ja Anthropicuga ühilduva error.type’i reegleid ning konsoolivaadet limiitide ja kasutuse kontrollimiseks.
Olekukood
| Kood | Tähendus | Toiming |
|---|---|---|
| 400 | Päringu väärtuse viga. Anthropicuga ühilduvate mudelite loendi limit jääb vahemikust 1~1000 välja või prooviti salvestatud vastuse jätkamiseks kasutada GET /responses/{responseId}?stream=true päringut | Parandage väärtus lubatud vahemikku. Salvestatud vastuseid pärige ilma stream-parameetrita. |
| 401 | Võti puudub või võti on aegunud või tühistatud | Kontrollige võtme olekut API-võtmete lehel ning kontrollige päise nime ja Bearer-prefiksit. |
| 403 | Mudelile puudub juurdepääsuõigus, kasutuslimiit on ületatud, krediiti pole piisavalt või te ei ole hääle omanik | error.message eristab põhjuseid. Väärtusi näete allolevas limiitide ja kasutuse kontrollimise jaotises kirjeldatud vaates. |
| 404 | Mudelit pole olemas või sellele ei pääse selle võtmega juurde (sh mudelid, mille tugi on lõppenud), teed pole olemas või CleviDrive’i väljund on säilitusperioodi (3 päeva) ületanud | Kontrollige esmalt GET /models abil kutsutavate mudelite loendit. Võrrelge teed API-kõnede tegemise lehel oleva tabeliga. |
| 408 · 409 · 413 | Ülesvooluteenuse ajalõpp, ülekoormus või päringu suuruse ületamine. Kõne- ja hääleteede ajapiirang on 5 minutit ning päringu ülempiir 28 MiB | Kui 409 vastuses on Retry-After, oodake määratud aja. 413 korral jagage päring osadeks. |
| 429 | Ülesvooluteenuse pakkuja kehtestatud kiiruspiirang | Kui Retry-After on olemas, järgige seda; selle puudumisel proovige eksponentsiaalse tagasipöördumisega uuesti. |
| 5xx | Lüüsi või ülesvooluteenuse ajutine viga (sh 503) | Proovige eksponentsiaalse tagasipöördumisega uuesti. Kui probleem kordub, teatage sellest abikeskuse ja kontaktivormi kaudu, lisades X-Request-Id väärtuse. |
Korduskatse
Lüüs ei loo ise 429 vastuseid ega proovi ülesvooluteenuse vastuseid kasutaja teadmata uuesti ega lisa neid järjekorda.
Ootamise ja korduskatsete eest vastutab klient.
| Kood | Ooteaeg | Seejärel |
|---|---|---|
| 409 | Kui Retry-After on olemas, siis selle aja | Saadame sama päringu uuesti. |
| 429 | Kui Retry-After on olemas, siis selle aja; kui mitte, siis eksponentsiaalne tagasipöördumine | Saadame sama päringu uuesti. |
| 5xx | Eksponentsiaalne tagasipöördumine | Kui see kordub, võtame ühendust. |
| 413 | Ooteaega ei ole | Jagame päringu osadeks. |
Veatekst
Veateksti vorm erineb spetsifikatsiooniti. Ülesvoolu tõrgetest edastame pärast korrastamist ainult sõnumi; pinu ega sisemisi välju ei edastata.
OpenAI-ga ühilduva tee sisu.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropicuga ühilduva tee sisu. error.type määratakse olekukoodi põhjal.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Olekukood | 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 |
| Muud koodid | api_error |
Piirangute ja kasutuse kontrollimine
Piirangute väärtused erinevad tööruumiti. Kontrollige 403 põhjendust väljal error.message ja vaadake seejärel väärtusi alloleval ekraanil.
| Kontrollitav | Konsoolivaade |
|---|---|
| Minu tööruumile kehtestatud piirang | Ülevaate eraldatud kasutuspiirang |
| Plaani lubatud ulatus ja saldo | Plaan ja krediidid |
| Tegelik kasutus (kõnede arv mudeli ja võtme kaupa, eeldatavad mahaarvatavad krediidid) | Kasutus |
| Võtme olek (kas aegunud või tühistatud) | API-võti |