Source: https://ailoot.ai/docs/kk/errors/ Canonical: https://ailoot.ai/docs/kk/errors/ Language: kk [Көмек](https://ailoot.ai/docs/kk/) # Қателер және лимиттер [Markdown](https://ailoot.ai/docs/kk/errors/index.md) Жауап кодтары, олардың мағынасы және не істеу керегі. Барлық қате JSON форматында және Request ID-мен келеді. ## [](https://ailoot.ai/docs/kk/errors/#format)Қате форматы Қате шақырған API форматына сай келеді: мына нысан: `error` OpenAI үшін, `{"type": "error", "error": {...}}` Anthropic үшін және `error` мына өрістері бар: `status` және `details` Gemini үшін. Сондықтан SDK оларды кәдімгі API қателері ретінде таниды. - `error.code` және `error.reason` — төмендегі кестедегі қате класы, олардың мәндері бірдей. `error.type` — форматтың стандартты мәні (мысалы, `invalid_request_error` немесе `server_error`). - `error.request_id` (Anthropic ішінде — `request_id` жоғарғы деңгейде), мына тақырып: `X-Request-ID` және хабарлама мәтінінің соңы — сұрау идентификаторы. - Gemini ішінде класс мына жерде: `error.details`: `ErrorInfo.reason` — сол код бас әріптермен (мысалы, `MODEL_OVERLOADED`), `domain` — `ailoot.ai`; сұрау идентификаторы — мына жерде: `RequestInfo.requestId`. - Gemini форматында автоматты түрде қайталауға болмайтын 5xx қатесі және `result_pending_check` 409 күйімен және мына мәнмен келеді: `status` `ABORTED`: сонда Gemini SDK мен CLI оларды өздері қайталамайды. Қате класы — мына жерде: `ErrorInfo.reason` (мысалы, `MODEL_TIMEOUT` немесе `RESULT_PENDING_CHECK`). - OpenAI форматындағы жауапта қосымша жоғарғы деңгей өрістері бар: `code` және `message` — ескі клиенттер үшін. ```json { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.", "param": null, "reason": "invalid_api_key", "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } ``` ```json { "type": "error", "error": { "type": "authentication_error", "code": "invalid_api_key", "reason": "invalid_api_key", "message": "… Nothing was charged. … Request ID: 94ed3e31-4373-41ce-bf8a-0d1ed3f7235e." }, "request_id": "94ed3e31-4373-41ce-bf8a-0d1ed3f7235e" } ``` ```json { "error": { "code": 401, "status": "UNAUTHENTICATED", "message": "The API key is not valid. Nothing was charged. … Request ID: e7aa743b-9d0d-4064-b206-2562609f545b.", "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "reason": "INVALID_API_KEY", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "e7aa743b-9d0d-4064-b206-2562609f545b" } }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "e7aa743b-9d0d-4064-b206-2562609f545b" } ] } } ``` “Nothing was charged” қаражат есептен шығарылмағанын білдіреді. X-Should-Retry: false келсе — автоматты түрде қайталамаңыз, алдымен тарихтан Request ID-ді тексеріңіз. ## [](https://ailoot.ai/docs/kk/errors/#codes)Қате кодтары | HTTP | Класс (reason) | Не болды | Не істеу керек | | --- | --- | --- | --- | | 400 | `invalid_request` | Сұрау қате: денесі немесе параметрі дұрыс емес; модель сұраудағы өрісті, тіркемені немесе құралды қолдамайды; кілт мекенжайда берілген | Сұрауды қате мәтініне қарай түзетіңіз: қолдау көрсетілмейтін өрісті, тіркемені немесе құралды алып тастаңыз; кілтті тақырыпта жіберіңіз. Қолдау көрсетілмейтін өріс, тіркеме немесе құрал үшін бас тарту резервке дейін болады — ештеңе есептен шығарылмаған | | 400 | `context_length_exceeded` | Сұрау модель контекстінен ұзын | Тарихты қысқартыңыз немесе контексті үлкенірек модельді таңдаңыз | | 400 | `content_policy_violation` | Сұрау модель ережелері бойынша қабылданбады | Сұрауды басқаша тұжырымдаңыз | | 401 | `invalid_api_key` | Кілт жоқ немесе қате | Кілттің толық жіберілгенін тексеріңіз | | 401 | `api_key_disabled` | Кілт өшірілген | Кілтті қосыңыз немесе жаңасын жасаңыз | | 402 | `insufficient_balance`, `insufficient_quota` | Бос баланс ең аз резервке де жетпейді (`insufficient_quota` — OpenAI SDK үшін үйреншікті түрде берілген дәл сол жағдай) | Балансты толықтырыңыз немесе max\_tokens мәнін азайтыңыз | | 402 | `api_key_quota_exhausted` | Кілттің жалпы шығын лимиті біткен | Жеке кабинетте кілт лимитін арттырыңыз | | 402 | `payment_disputed` | Аккаунтта дауланған төлем бойынша қарыз бар | Жаңа сұраулар қарыз өтелгенше тоқтатылған — қолдау қызметіне жазыңыз | | 403 | `api_key_expired` | Кілттің жарамдылық мерзімі біткен | Жаңа кілт жасаңыз | | 403 | `account_inactive` | Аккаунтыңыз өшірілген | Қолдау қызметіне жазыңыз | | 403 | `permission_denied` | Бұл кілтпен осы сұрауды жіберуге тыйым салынған (мысалы, IP бойынша) | Кілт шектеулерін тексеріңіз | | 404 | `model_not_found` | Мұндай модель жоқ | ID-ді /v1/models тізімімен салыстырыңыз | | 404 | `unsupported_endpoint` | Модель бұл форматта жұмыс істемейді | Басқа форматты немесе модельді таңдаңыз | | 404 | `not_found` | Мұндай жол немесе нысан (мысалы, тапсырма) жоқ | Мекенжай мен идентификаторды тексеріңіз | | 409 | `duplicate_request` | Дәл сол идемпотенттік кілті бар операция қабылданған және аяқталған болуы мүмкін | Бірінші операция нәтижесін тексеріңіз, жаңасын жібермеңіз | | 409 | `not_ready`, `video_not_ready` | Бейне немесе басқа тапсырма әлі дайын емес | Күйін кейінірек сұраңыз | | 409, 503 | `result_pending_check` | Сұрау нәтижесін нақтылап жатырмыз. Бейне тапсырмасында бұл мына белгі: `result_pending_check: true` күй жауабында, ал тапсырманың өзі мына күйде қалады: `in_progress` | Сұрауды қайта жібермеңіз — күйі тарихта пайда болады (GET https://ailoot.ai/api/v1/usage). Бейне тапсырмасын қайта жасамаңыз: кейінірек GET /v1/videos/{id} арқылы тексеріңіз | | 410 | `model_retired` | Модель қызмет көрсетуден алынған | GET /v1/models тізімінен жаңа нұсқасын таңдаңыз | | 413 | `request_too_large` | Сұрау денесі тым үлкен | Файлдарды немесе тарихты қысқартыңыз | | 429 | `rate_limit_exceeded`, `gateway_concurrency_limit`, `gateway_queue_full` | Аккаунтыңыздан тым көп сұрау немесе бір мезгілде тым көп сұрау жіберілген | Күтіңіз (мына тақырып: `Retry-After`, әдетте 10 с), содан кейін қайталаңыз | | 429 | `usage_limit_reached` | Кілттің шығын аралығы біткен (5 сағат, 1 күн немесе 7 күн) | Аралық жаңарғанша күтіңіз немесе кілт лимитін арттырыңыз | | 500 | `internal_error` | Ailoot қатесі | Request ID-мен қолдау қызметіне жазыңыз | | 502 | `invalid_model_response`, `empty_response`, `incomplete_response` | Модель қате, бос немесе толық емес жауап қайтарды | Жеке кабинет тарихынан Request ID-ді табыңыз. Нәтиже немесе есептен шығару бар болса, қайталау екінші ақылы сұрау жасайды. Жазбаның болмауы сұраудың жіберілмегенін немесе орындалмағанын растамайды: жіберілу күйі белгісіз сұрауды қайталамаңыз; Request ID-ді көрсетіп, қолдау қызметіне хабарласыңыз. | | 502 | `result_not_delivered` | Нәтиже Ailoot кінәсінен жеткізілмеді, резерв немесе есептен шығарылған сома қайтарылды | Сұрауды қайта жіберуге болады | | 503 | `model_overloaded` | Модель уақытша шамадан тыс жүктелген | X-Should-Retry: true болса — Retry-After секундтан кейін қайталаңыз; false болса — алдымен тарихтан Request ID-ді тексеріңіз | | 503 | `model_unavailable` | Модель уақытша қолжетімсіз | Басқа модельді таңдаңыз. X-Should-Retry: true болса — Retry-After секундтан кейін қайталаңыз; false болса — алдымен тарихтан Request ID-ді тексеріңіз | | 503 | `service_unavailable` | Ailoot жағындағы уақытша ақау | X-Should-Retry: true болса — Retry-After секундтан кейін қайталаңыз; false болса — алдымен тарихтан Request ID-ді тексеріңіз | | 503 | `charge_not_confirmed` | Жауап берілмеді: есептен шығаруды растау мүмкін болмады; резерв қайтарылды, қаражат есептен шығарылмаған | X-Should-Retry: true болса — Retry-After секундтан кейін қайталаңыз; false болса — алдымен тарихтан Request ID-ді тексеріңіз | | 504 | `model_timeout` | Модель уақытында жауап бермеді, нәтиже әлі де пайда болуы мүмкін | Тарихтан Request ID-ді тексермейінше сұрауды қайта жібермеңіз | Модель жауаптары мен нәтижені тексеру кодтары (502, 503 және 504) енді модельді немесе сұрауды атайды: `model_unavailable`, `model_timeout`, `invalid_model_response`, `incomplete_response`, `charge_not_confirmed` және `result_pending_check`. Кодыңыз мына өрісті: `error.code` бұрынғы мәндермен салыстырса, оларды кестедегі кодтарға ауыстырыңыз; бұрынғы және жаңа кодтардың сәйкестігін мына қызмет түсіндіреді: [қолдау қызметі](https://ailoot.ai/docs/kk/support/). ## [](https://ailoot.ai/docs/kk/errors/#retry)Сұрауды қашан қайталау керек - **Алдымен X-Should-Retry мәнін қараңыз**: мәні `false`, `result_pending_check` немесе `model_timeout` болса, автоматты түрде қайталамаңыз. Жеке кабинет тарихынан Request ID-ді табыңыз: онда нәтиже мен есептен шығару көрінеді. - **X-Should-Retry: true келгенде қайталау қауіпсіз**: күтіңіз, `Retry-After` секунд. 5xx үшін кодтың өзі жеткіліксіз: нәтиже пайда болып қойған болуы мүмкін. Алдымен жеке кабинеттегі тарихты тексеріңіз немесе Request ID-мен қолдау қызметіне жазыңыз. Бұл әсіресе суреттер, бейне, музыка және агенттің ұзақ қадамдары үшін маңызды. - **Қайталау көмектеспейді**: 400, 401, 402, 403, 404 — алдымен сұрауды, кілтті немесе балансты түзетіңіз. OpenAI және Anthropic SDK-лары әдетте желілік қателер мен 5xx-ті автоматты түрде қайталайды. Генерациялар үшін мұны өшіріңіз (`max_retries=0`) және мынаны тексеріңіз: `X-Should-Retry` жаңа әрекет алдында. Жауаптың жоғалуы сұраудың орындалмағанын білдірмейді. ## [](https://ailoot.ai/docs/kk/errors/#limits)Лимиттер Жиілік пен бір мезгілдегі сұраулар саны жеке кілт үшін емес, бүкіл аккаунтыңыз үшін шектеледі. Шектен асса, 429 келеді: `rate_limit_exceeded` мына тақырыппен: `Retry-After: 10`. Модельдің өзі шамадан тыс жүктелсе — 503: `model_overloaded` мынамен бірге: `Retry-After: 30`. Үлкен жүктеме қажет болса, мына қызметке жазыңыз: [қолдау қызметіне](https://ailoot.ai/docs/kk/support/). Шығын лимиттері кілтте қойылады: жалпы лимит — 402 `api_key_quota_exhausted`, 5 сағат, 1 күн және 7 күн аралықтары — 429 `usage_limit_reached`. Толығырақ — [Кілттер және API мекенжайы](https://ailoot.ai/docs/kk/keys/#key). ## [](https://ailoot.ai/docs/kk/errors/#nvidia)NVIDIA модельдері: кезек Модельдер тізімін нөлдік баланста да сұрауға болады; генерация үшін резервке баланс қажет. NVIDIA модельдері (Nemotron және басқалары) ортақ кезек арқылы жұмыс істейді: жүктеме жоғары болса, жауап кешірек келуі мүмкін немесе Retry-After тақырыбы бар «модель уақытша шамадан тыс жүктелген» қатесі қайтарылады — көрсетілген уақыттан кейін қайталаңыз. Бағалар каталогта, есептен шығару басқа модельдердегідей. Көлем лимиттерін модель белгілейді: контекст (қанша токен жіберуге болады) және жауаптың ең көп ұзындығы. Олар мына жерде көрсетілген: [каталогта](https://ailoot.ai/models/kk/). ## Тарих және шығындар [Тарих және шығындар](https://ailoot.ai/usage) · [GET https://ailoot.ai/api/v1/usage](https://ailoot.ai/docs/kk/cabinet/usage/) · JWT · `Authorization: Bearer $TOKEN` `JWT ≠ sk-…` · [Кіру және сеанстар](https://ailoot.ai/docs/kk/cabinet/auth/) Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai) ## Ailoot · Компания және оның жобалар портфелі Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді. Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі. Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.