Developer guide
Қате коды
Күй кодтары бойынша әрекет ету және қайта әрекет жасау ережелері
Бұл бетте шлюз қайтаратын күй кодтары мен олардың мағынасы, сондай-ақ әр код бойынша орындалатын әрекеттер жинақталған.
Егер upstream 4xx·5xx қайтарса, сол кодты өзгеріссіз қайтарамыз, ал басқа жағдайларда төмендегі кестені қолданамыз.
Сонымен қатар екі үйлесімділік стандартының қате мәтінінің пішімі, Anthropic үйлесімді error.type ережелері, сондай-ақ лимиттер мен пайдалануды тексеруге арналған консоль экраны берілген.
Күй коды
| Код | Мағынасы | Әрекет |
|---|---|---|
| 400 | Сұрау мәнінде қате бар. Anthropic үйлесімді модельдер тізіміндегі limit 1~1000 аралығынан тыс немесе GET /responses/{responseId}?stream=true арқылы сақталған жауапты жалғастыру әрекеті жасалған | Мәнді рұқсат етілген ауқымға келтіріңіз. Сақталған жауапты stream параметрінсіз алыңыз. |
| 401 | Кілт жоқ немесе оның мерзімі өткен не кілт жойылған | API кілттері экранынан кілт күйін тексеріп, тақырып атауы мен Bearer префиксін тексеріңіз. |
| 403 | Модельге қол жеткізуге рұқсат жоқ, пайдалану лимиті асқан, кредит жеткіліксіз немесе дауыстың иесі емессіз | error.message себебін ажыратып көрсетеді. Мәндерді төмендегі лимиттер мен пайдалануды тексеру бөліміндегі экраннан көріңіз. |
| 404 | Модель жоқ немесе оған осы кілтпен қол жеткізу мүмкін емес (қолдауы тоқтатылған модельдерді қоса), жол жоқ немесе сақтау мерзімі 3 күннен асқан CleviDrive нәтижесі | Алдымен GET /models арқылы шақыруға болатын модельдер тізімін тексеріңіз. Жолды API шақыру бетінде берілген кестемен салыстырыңыз. |
| 408 · 409 · 413 | Upstream уақытының аяқталуы, шамадан тыс жүктеме немесе сұрау өлшемінің асып кетуі. Дауыс·voice жолдары үшін уақыт шегі — 5 минут, ал сұрау шегі — 28 MiB | Егер 409 жауабында Retry-After болса, көрсетілген уақыт бойы күтіңіз. 413 жағдайында сұрауды бөліп жіберіңіз. |
| 429 | Upstream провайдері жылдамдық лимитін қойған жағдайда | Retry-After берілсе, оны өзгеріссіз орындаңыз, ал берілмесе, экспоненциалды арттыру арқылы қайта әрекет жасаңыз. |
| 5xx | Шлюз немесе upstream тарапындағы уақытша қате (503 қоса) | Экспоненциалды арттыру арқылы қайта әрекет жасаңыз. Қате қайталанса, анықтама орталығы мен байланыс арналары арқылы X-Request-Id мәнімен бірге хабарлаңыз. |
Қайта әрекет жасау
Шлюз өздігінен 429 жасамайды, сондай-ақ upstream жауабын жасырын түрде қайта жібермейді немесе кезекке қоймайды.
Күту мен қайта әрекет жасауды клиент орындайды.
| Код | Күту уақыты | Содан кейін |
|---|---|---|
| 409 | Retry-After болса, көрсетілген уақыт | Сол сұрауды қайта жібереді. |
| 429 | Retry-After болса, көрсетілген уақыт, болмаса экспоненциалды кері шегіну | Сол сұрауды қайта жібереді. |
| 5xx | Экспоненциалды кері шегіну | Қайталанса, хабарласыңыз. |
| 413 | Күтпейді | Сұрауды бөліктерге бөледі. |
Қате мәтіні
Қате мәтінінің пішімі спецификацияға байланысты әртүрлі болады. Жоғарғы ағыннан келген қатені тек хабарламасын қалдырып, өңдеп жеткіземіз; стек пен ішкі өрістер берілмейді.
OpenAI үйлесімді жолдың мәтіні.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Anthropic үйлесімді жолдың мәтіні. error.type күй кодына қарай анықталады.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Күй коды | 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 |
| Басқа кодтар | api_error |
Лимиттер мен пайдалануды тексеру
Лимит мәндері жұмыс кеңістігіне қарай өзгереді. 403 себебін error.message арқылы тексеріп, төмендегі экраннан мәндерді қараңыз.
| Тексерілетін нәрсе | Консоль экраны |
|---|---|
| Менің жұмыс кеңістігіме қойылған лимит | Шолудағы бөлінген пайдалану лимиті |
| Жоспар рұқсат ететін ауқым және қалдық | Жоспар және кредиттер |
| Нақты пайдалану (модель және кілт бойынша қоңыраулар саны, болжамды шегерілетін кредиттер) | Пайдалану |
| Кілт күйі (мерзімі біткен-бітпегені, қайтарып алынған-алынбағаны) | API кілттері |