Developer guide
Kļūdas kods
Rīcība un atkārtošanas noteikumi atbilstoši statusa kodam
Šajā lapā ir apkopoti vārtejas atgrieztie statusa kodi un to nozīme, kā arī rīcība atbilstoši katram kodam.
Ja augšupējais pakalpojums atgriež 4xx·5xx, šis kods tiek pārsūtīts tālāk nemainīts; pārējos gadījumos jāievēro tālāk redzamā tabula.
Šeit ir aprakstīts arī abu saderīgo specifikāciju kļūdas pamatteksta formāts, Anthropic saderīgā error.type noteikumi un konsoles ekrāns limitu un lietojuma pārbaudei.
Statusa kods
| Kods | Nozīme | Rīcība |
|---|---|---|
| 400 | Pieprasījuma vērtības kļūda. Anthropic saderīgo modeļu saraksta limit ir ārpus diapazona 1~1000 vai arī ir mēģināts turpināt saglabātas atbildes saņemšanu, izmantojot GET /responses/{responseId}?stream=true | Izlabojiet vērtību, lai tā būtu atļautajā diapazonā. Saglabātās atbildes iegūstiet bez stream. |
| 401 | Atslēga nav norādīta vai tā ir beigusies vai atsaukta | API atslēgu lapā pārbaudiet atslēgas statusu, kā arī pārbaudiet galvenes nosaukumu un Bearer prefiksu. |
| 403 | Nav piekļuves modeļiem, pārsniegts lietojuma limits, nepietiek kredītu vai lietotājs nav balss īpašnieks | error.message norāda konkrēto iemeslu. Skaitliskās vērtības skatiet ekrānā, kas aprakstīts tālāk sadaļā par limitu un lietojuma pārbaudi. |
| 404 | Modelis neeksistē vai tam nevar piekļūt ar šo atslēgu (tostarp modeļi, kuru atbalsts ir pārtraukts), ceļš neeksistē vai ir pagājušas 3 dienas kopš CleviDrive rezultāta saglabāšanas termiņa beigām | Vispirms ar GET /models pārbaudiet to modeļu sarakstu, kurus var izsaukt. Salīdziniet ceļu ar tabulu API izsaukšanas lapā. |
| 408 · 409 · 413 | Augšupējā pakalpojuma taimauts, pārslodze vai pārsniegts pieprasījuma lielums. Balss·voice ceļa maksimālais laiks ir 5 minūtes, bet pieprasījuma limits — 28 MiB | Ja 409 atbildē ir Retry-After, nogaidiet norādīto laiku. Ja saņemts 413, sadaliet pieprasījumu daļās. |
| 429 | Augšupējais pakalpojuma sniedzējs ir piemērojis ātruma ierobežojumu | Ja ir Retry-After, ievērojiet to nemainītu; ja tā nav, atkārtojiet mēģinājumu ar eksponenciālu atkāpšanos. |
| 5xx | Īslaicīga vārtejas vai augšupējā pakalpojuma kļūda (tostarp 503) | Atkārtojiet mēģinājumu ar eksponenciālu atkāpšanos. Ja kļūda atkārtojas, informējiet mūs palīdzības sadaļā un saziņas veidlapā, norādot X-Request-Id. |
Atkārtots mēģinājums
Vārteja pati neveido 429 atbildes, kā arī slepeni nemēģina atkārtoti nosūtīt augšupējā pakalpojuma atbildes un neievieto tās rindā.
Nogaidīšanu un atkārtotus mēģinājumus veic klients.
| Kods | Gaidīšanas laiks | Pēc tam |
|---|---|---|
| 409 | Ja ir Retry-After, nogaidiet norādīto laiku | Atkārtoti nosūtiet to pašu pieprasījumu. |
| 429 | Ja ir Retry-After, nogaidiet norādīto laiku; ja nav, izmantojiet eksponenciālo atkāpšanos | Atkārtoti nosūtiet to pašu pieprasījumu. |
| 5xx | Eksponenciālā atkāpšanās | Ja kļūda atkārtojas, sazinieties ar atbalsta dienestu. |
| 413 | Negaidiet | Sadaliet pieprasījumu daļās. |
Kļūdas pamatteksts
Kļūdas pamatteksta formāts atšķiras atkarībā no specifikācijas. Augšupējās kļūdas tiek nosūtītas sakārtotā veidā, saglabājot tikai ziņojumu; steka un iekšējie lauki netiek pārsūtīti.
OpenAI saderīgā ceļa pamatteksts.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropic saderīgā ceļa pamatteksts. error.type tiek noteikts pēc statusa koda.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Statusa kods | 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 |
| Citi kodi | api_error |
Kvotu un lietojuma pārbaude
Kvotu vērtības atšķiras katrā darbvietā. Vispirms pārbaudiet 403 iemeslu error.message un pēc tam skatiet vērtības tālāk norādītajos ekrānos.
| Pārbaudāmais | Konsoles ekrāns |
|---|---|
| Manai darbvietai piemērotā kvota | Piešķirtā lietojuma kvota sadaļā “Pārskats” |
| Plāna atļautais diapazons un atlikums | Plāns un kredīti |
| Faktiskais lietojums (izsaukumu skaits pēc modeļa un atslēgas, paredzamie atskaitāmie kredīti) | Lietojums |
| Atslēgas statuss (vai tā ir beigusies vai anulēta) | API atslēga |