Ключ API не працює? Як виправити помилки 401, 402, 403 і 429
Чому ключ API сервісу ШІ перестає працювати: що означають 401, 402, 403 і 429, який код повертає кожен постачальник, коли закінчився баланс, і як це виправити.
- Коли ключ API сервісу ШІ «не працює», причину підказує номер помилки: 401 — неправильний сам ключ, 402 — найчастіше закінчилися баланс чи кредити, 403 — ключу не дозволено цю дію, а 429 — забагато запитів або, в окремих постачальників, порожній баланс.
- Постачальники по-різному позначають порожній баланс. DeepSeek, OpenRouter, Mistral, Together, Fireworks і передплачена оплата Gemini використовують 402; OpenAI, Kimi та Z.ai — 429; Qwen від Alibaba Cloud — 403. Читайте повідомлення, а не лише номер.
- Помилки балансу з часом не зникають, а обмеження частоти запитів зазвичай минають самі. У таблиці нижче — офіційна сторінка помилок кожного постачальника, перевірено 18 листопада 2026 року.

Що насправді означає «ключ API не працює»?
Ключ API — це секретний код, який застосунок надсилає з кожним запитом, щоб постачальник ШІ знав, що це ви і з чийого акаунта списувати оплату. Коли щось іде не так, постачальник відповідає помилкою: тризначним числом — кодом стану HTTP — і коротким повідомленням.
Число вказує на тип проблеми, а повідомлення — на подробиці. Oriveo перетворює найпоширеніші помилки на зрозумілі заголовки, як-от «Недійсний ключ API» чи «Квоту постачальника вичерпано»; їх пояснено нижче на цій сторінці.
Коротко: 401, 402, 403, 429 і 5xx
Почніть звідси: знайдіть свій код, а потім прочитайте відповідний розділ нижче. Цей підсумок спирається на сторінки помилок OpenAI, Anthropic та інших постачальників станом на 18 листопада 2026 року.
| Код | Що зазвичай означає | Чи допоможе очікування? | Що робити |
|---|---|---|---|
| 401 | Ключ неправильний: бракує символу, є зайвий пробіл, ключ видалено або він від іншого постачальника чи регіону | Ні | Скопіюйте ключ ще раз або створіть новий; перевірте постачальника й регіон |
| 402 | Потрібна оплата: закінчилися передплачений баланс чи кредити або є проблема з оплатою | Ні | Поповніть баланс або виправте спосіб оплати на сторінці оплати постачальника |
| 403 | Ключ робочий, але дію не дозволено: країна чи регіон не підтримуються, немає доступу до моделі або потрібна верифікація | Ні | Перевірте підтримувані регіони, дозволи ключа й вимоги до верифікації |
| 404 | Неправильна назва моделі або адреса | Ні | Виберіть іншу модель або перевірте адресу |
| 429 | Забагато запитів за короткий час або, в окремих постачальників, порожній баланс чи ліміт витрат | Часто так, якщо це обмеження частоти | Зачекайте й повторіть; якщо в повідомленні йдеться про квоту, баланс, кредит чи ліміт витрат, поповніть баланс або збільште ліміт |
| 500–504, 529 | Збій чи перевантаження на боці постачальника | Зазвичай так | Спробуйте пізніше або змініть модель |
Чому з’являється помилка про нестачу балансу чи квоти?
Більшості постачальників для роботи API потрібні передплачені кошти або активний спосіб оплати, і кожен повідомляє про порожній баланс по-своєму. Новий ключ тут не допоможе, а поповнення — допоможе.
Нижче — код, який кожен із 15 вбудованих постачальників Oriveo вказує в документації на випадок, коли закінчуються баланс чи кредити. «Не вказано» означає, що в документації постачальника, перевіреній 18 листопада 2026 року, HTTP-коду для цього випадку немає.
| Постачальник | Код, коли закінчився баланс | Що в повідомленні | Офіційна сторінка |
|---|---|---|---|
| OpenAI | 429 | credit_balance_exhausted (тип помилки може й далі бути insufficient_quota) | developers.openai.com/api/docs/guides/error-codes |
| Anthropic (Claude) | Не вказано | «Your credit balance is too low to access the Anthropic API»; у разі проблем з оплатою повертається 402 billing_error | platform.claude.com/docs/en/api/errors (коди); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (повідомлення) |
| Google Gemini | 402 (передплачена оплата) | payment_required; 403 також може означати неоплачений баланс Cloud Billing | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | Вашому акаунту або ключу API бракує кредитів | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | Не вказано | Коли передплачені кредити закінчуються, запити відхиляються | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | Не задокументовано | Groq виставляє рахунок після використання; на його сторінці помилок немає помилки балансу | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | Не вказано (бізнес-код 1008) | insufficient balance | platform.minimax.io/docs/api-reference/errorcode |
| Z.ai (GLM) | 429 (код 1113) | Insufficient balance or no resource package. Please recharge. | docs.z.ai/api-reference/api-code |
| Qwen (Alibaba Cloud) | 403 | Arrearage або isv.OUT_OF_SERVICE (заборгованість на акаунті) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | Не задокументовано | Помилки балансу не наведено | docs.siliconflow.com/en/faqs/error-code |
401: недійсний ключ API або помилка автентифікації
Помилка 401 означає, що постачальник не розпізнає ключ. Типові повідомлення: «Incorrect API key provided» (OpenAI), «authentication_error» (Anthropic), «Authentication Fails» (DeepSeek) та «Invalid API key: this is not an OpenRouter API key» (OpenRouter).
- Скопіюйте ключ ще раз із сайту постачальника й перевірте, чи не бракує символів і чи немає пробілів на початку або в кінці.
- Переконайтеся, що ключ належить вибраному постачальнику. Ключ OpenAI не спрацює як ключ OpenRouter, і навпаки.
- Kimi, MiniMax і Qwen мають окремі регіональні платформи, і ключ з однієї не працює на іншій. В Oriveo виберіть відповідний регіон у списку «Офіційна кінцева точка» (на iPhone — «Офіційний URL запиту»).
- Якщо ключ видалено, відкликано або строк його дії минув, створіть новий.
402: потрібна оплата або бракує коштів на балансі
Помилка 402 стосується грошей: передплачений баланс порожній або платіж не пройшов. Поповніть баланс чи оновіть платіжні дані на сторінці оплати постачальника й надішліть повідомлення знову. Очікування не допоможе.
Oriveo показує це як «Квоту постачальника вичерпано»: «Постачальник повідомляє, що квоту або кошти для цього ключа API вичерпано. Перевірте рахунок у постачальника або змініть модель.»
403: доступ заборонено або немає дозволу
Помилка 403 означає, що постачальник розпізнав ключ, але не дозволяє цей запит. Причина залежить від постачальника:
- OpenAI повертає «Country, region, or territory not supported», коли API використовують із країни, яку він не підтримує. Кожен постачальник публікує свій список підтримуваних країн.
- Gemini повертає 403, коли проєкт на безкоштовному рівні потребує верифікації (FREE_TIER_VERIFICATION_REQUIRED), коли на пов’язаному акаунті Cloud Billing є неоплачений баланс або коли Google заблокував ключ, про витік якого повідомили.
- Anthropic повертає permission_error, коли ключ не має доступу до ресурсу; перевірте налаштування організації та робочого простору.
- OpenRouter повертає 403, коли запит заблоковано через дозволи, модерацію, захисне правило (guardrail) чи бюджетний ліміт.
- SiliconFlow вимагає підтвердити особу для деяких моделей.
- Qwen використовує 403 для акаунта із заборгованістю, а також для помилки AllocationQuota.FreeTierOnly, коли безкоштовну квоту вичерпано й увімкнено налаштування «Free Quota Only».
429: забагато запитів, обмеження частоти або перевищення квоти
Здебільшого 429 означає, що ви надіслали забагато запитів чи токенів за короткий час. Це обмеження частоти запитів (rate limit), і воно зникає, якщо зачекати кілька десятків секунд. Якщо у відповіді є час Retry-After, зачекайте саме стільки.
Деякі постачальники повертають 429 і тоді, коли баланс порожній або досягнуто ліміту витрат, і в таких випадках очікування не допоможе. Це OpenAI (credit_balance_exhausted або встановлений вами ліміт витрат), Kimi (exceeded_current_quota_error), Z.ai (код 1113) та Anthropic, коли організація досягає місячного ліміту витрат (enforced_spend_limit_reached): цей ліміт діє до наступного місяця, якщо не запросити вищий рівень.
На безкоштовних рівнях обмеження жорсткіші. Безкоштовний рівень Gemini та безкоштовні моделі OpenRouter мають ліміти на хвилину й на день.
Обмеження частоти Oriveo позначає як «Перевищено ліміт запитів» у вебі або «Постачальник обмежив частоту запитів» на iPhone та Android. Якщо ж у повідомленні йдеться про квоту чи кредит, Oriveo натомість показує «Квоту постачальника вичерпано».
Що означають повідомлення про помилки в Oriveo?
Ось повідомлення, які ви можете побачити в Oriveo українською:
| Що показує Oriveo | Що це означає | Що робити |
|---|---|---|
| Збережено, але ключ виглядає недійсним. Ви можете перевірити його пізніше в налаштуваннях постачальника. | Oriveo зберіг постачальника, але під час перевірки постачальник відхилив ключ | Скопіюйте ключ ще раз і оновіть його в налаштуваннях цього постачальника |
| Недійсний ключ API | Постачальник повернув 401 або 403 | Перевірте або замініть ключ; у разі 403 перевірте регіон і дозволи |
| Квоту постачальника вичерпано | Постачальник повідомляє, що кредит чи квоту для цього ключа вичерпано (402 або 429 зі згадкою про квоту) | Поповніть баланс у постачальника або перейдіть на іншу модель |
| Перевищено ліміт запитів (веб) / Постачальник обмежив частоту запитів (iPhone, Android) | Наразі забагато запитів (429) | Трохи зачекайте й спробуйте знову |
| Безкоштовну квоту вичерпано | Сьогоднішню квоту Oriveo Free використано; до вашого власного ключа це не має стосунку | Додайте власний ключ API або дочекайтеся оновлення квоти о 00:00 UTC |

Користуєтеся власною кінцевою точкою, посередницьким сервісом чи шлюзом?
Якщо ви підключаєтеся через власну кінцеву точку, помилка може йти від самого сервісу або від постачальника за ним. Коли Oriveo пише «Це з’єднання не змогло зв’язатися зі своїм постачальником», власний акаунт сервісу в постачальника може бути недійсним, без коштів або з обмеженням частоти запитів. Проблема не у ваших налаштуваннях: перейдіть на інше з’єднання або зверніться до того, хто керує сервісом.
Перевірте це, перш ніж створювати новий ключ
Новий ключ виправляє помилку 401 — і майже нічого більше. Спершу пройдіться цим списком:
- Ви вибрали правильного постачальника, а для Kimi, MiniMax, Qwen, SiliconFlow і Z.ai — ще й правильний регіон.
- Ви скопіювали ключ повністю, без пробілів.
- На акаунті є кошти або активний спосіб оплати.
- Ваша країна чи регіон є в списку підтримуваних у постачальника.
- Вибрана модель доступна для вашого акаунта чи рівня.
Поширені запитання
Чому не працює мій ключ API?
Що означає помилка 401 для ключа API?
Що таке помилка 402 Payment Required?
Помилка 429 — це обмеження частоти чи проблема з квотою?
Чому з ключем API OpenAI з’являється insufficient_quota?
Чому не працює новий ключ API, хоча його скопійовано правильно?
Читайте також
Зрозуміле пояснення помилки для кожного ключа
Відкрийте вебверсію або завантажте Oriveo для iPhone чи Android, додайте ключі 15 постачальників і дізнавайтеся, чому запит не пройшов.
Ще немає ключа API? Почніть з Oriveo Free — ключ не потрібен.