Developer guide
Kōleka hewa
Nā hana a me nā lula hoʻāʻo hou ma muli o ke kōleka kūlana
Hoʻonohonoho kēia ʻaoʻao i nā kōleka kūlana a ka ʻīpuka e hoʻihoʻi ai, ko lākou mau manaʻo, a me nā hana no kēlā me kēia kōleka.
Inā hāʻawi ka upstream i 4xx·5xx, hoʻoili pololei ʻia kēlā kōleka; no nā hihia ʻē aʻe, e hahai i ka papa ma lalo.
Ua hoʻokomo pū ʻia ke ʻano o ke kino hewa no nā kūlana kūlike ʻelua, nā lula o Anthropic compatibility error.type, a me ka pale console no ka nānā ʻana i nā palena a me ka hoʻohana.
Kōleka kūlana
| Kōleka | Manaʻo | Hana |
|---|---|---|
| 400 | Hewa nā waiwai o ka noi. Ua ʻoi aku ka limit o ka papa inoa hoʻohālike Anthropic compatibility ma mua o 1~1000, a i ʻole ua hoʻāʻo ʻia e hoʻomau i kahi pane i mālama ʻia me GET /responses/{responseId}?stream=true | Hoʻoponopono i nā waiwai i loko o ka laulā. Nānā i nā pane i mālama ʻia me ka ʻole o stream. |
| 401 | ʻAʻohe kī, a i ʻole ua pau ka manawa o ke kī a ua hoʻopau ʻia paha | E nānā i ke kūlana o ke kī ma ka pale API key, a nānā i ka inoa o ke poʻo a me ka prefix Bearer. |
| 403 | ʻAʻohe ʻae e komo i ke hoʻohālike, ua ʻoi aku ka palena hoʻohana, ua lawa ʻole nā hōʻaiʻē, a i ʻole ʻaʻole ʻo ia ka mea nona ka leo | Hoʻokaʻawale ʻo error.message i ke kumu. E nānā i nā helu ma ka pale ma ka ʻāpana nānā palena a me ka hoʻohana ma lalo. |
| 404 | ʻAʻohe hoʻohālike a ʻaʻole hiki ke komo me kēia kī (me nā hoʻohālike i pau ke kākoʻo ʻia), ʻaʻohe ala, a i ʻole he huahana CleviDrive i hala ka wā mālama o 3 lā | E nānā mua i ka papa inoa o nā hoʻohālike hiki ke kāhea ʻia me GET /models. E hoʻohālikelike i ke ala me ka papa ma ka ʻaoʻao Kāhea i ka API. |
| 408 · 409 · 413 | Ua pau ka manawa o ka upstream, ua huikau ke kikowaena, a i ʻole ua ʻoi aku ka nui o ka noi. No nā ala leo·voice, he 5 minuke ka palena manawa a he 28 MiB ka palena nui o ka noi | Inā loaʻa iā 409 ka Retry-After, kali no kēlā manawa. No 413, e hoʻokaʻawale i ka noi a hoʻouna i nā ʻāpana. |
| 429 | Ua kau ka mea hoʻolako upstream i ka palena wikiwiki | Inā loaʻa ka Retry-After, e hahai pololei iā ia; inā ʻaʻole, e hoʻāʻo hou me ka exponential backoff. |
| 5xx | Hewa manawa pōkole o ka ʻīpuka a i ʻole ka upstream (me 503) | E hoʻāʻo hou me ka exponential backoff. Inā hoʻomau, e hōʻike mai ma ke kōkua a me ka pilina, me X-Request-Id. |
Hoʻāʻo hou
ʻAʻole hana ka ʻīpuka i kāna 429 ponoʻī, ʻaʻole hoʻi e hoʻāʻo hou malū i ka pane upstream a i ʻole e hoʻokomo iā ia i ka lālani.
Na ka mea kūʻai aku e kali a e hoʻāʻo hou.
| Kānāwai | Manawa kali | A laila |
|---|---|---|
| 409 | Inā he Retry-After, kali i kēlā manawa | Hoʻouna hou i ka noi like. |
| 429 | Inā he Retry-After, kali i kēlā manawa; inā ʻaʻole, hoʻohana i ka exponential backoff | Hoʻouna hou i ka noi like. |
| 5xx | Exponential backoff | Inā hana hou ʻia, e hoʻokaʻaʻike mai. |
| 413 | ʻAʻohe kali | E hoʻokaʻawale i ka noi. |
Kino o ka hewa
ʻOkoʻa ke ʻano o ke kino o ka hewa ma muli o ka kikoʻī. No nā hewa upstream, waiho wale mākou i ka memo, hoʻomaʻemaʻe a hoʻouna aku; ʻaʻole hoʻouna ʻia nā stack a me nā kahua kūloko.
ʻO kēia ke kino o ke ala kūpono iā OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}ʻO kēia ke kino o ke ala kūpono iā Anthropic. Hoʻoholo ʻia ʻo error.type e ke code kūlana.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Code kūlana | 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 |
| Nā code ʻē aʻe | api_error |
Nānā i nā palena a me ka hoʻohana
ʻOkoʻa nā helu palena ma kēlā me kēia workspace. E nānā i ke kumu o ka 403 ma error.message, a laila e nānā i nā helu ma ka pale ma lalo.
| Mea e nānā ai | Pale console |
|---|---|
| Ka palena i kau ʻia ma koʻu workspace | Ka palena hoʻohana i hāʻawi ʻia ma ka Overview |
| Ka laulā i ʻae ʻia e ka plan a me ke koena | Plan a me nā hōʻaiʻē |
| Ka hoʻohana maoli (nā kāhea ma kēlā me kēia model a me key, a me nā hōʻaiʻē i manaʻo ʻia e unuhi ʻia) | Hoʻohana |
| Ke kūlana o ka key (inā ua pau ka mana a i ʻole ua hoʻopau ʻia) | API key |