Помилки ключа API

Ключ 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 року.
Oriveo на iPhone: екран постачальників зі списком підключених вами постачальників і витратами за цей місяць.

Що насправді означає «ключ API не працює»?

Ключ API — це секретний код, який застосунок надсилає з кожним запитом, щоб постачальник ШІ знав, що це ви і з чийого акаунта списувати оплату. Коли щось іде не так, постачальник відповідає помилкою: тризначним числом — кодом стану HTTP — і коротким повідомленням.

Число вказує на тип проблеми, а повідомлення — на подробиці. Oriveo перетворює найпоширеніші помилки на зрозумілі заголовки, як-от «Недійсний ключ API» чи «Квоту постачальника вичерпано»; їх пояснено нижче на цій сторінці.

Коротко: 401, 402, 403, 429 і 5xx

Почніть звідси: знайдіть свій код, а потім прочитайте відповідний розділ нижче. Цей підсумок спирається на сторінки помилок OpenAI, Anthropic та інших постачальників станом на 18 листопада 2026 року.

Коротко: 401, 402, 403, 429 і 5xx
КодЩо зазвичай означаєЧи допоможе очікування?Що робити
401Ключ неправильний: бракує символу, є зайвий пробіл, ключ видалено або він від іншого постачальника чи регіонуНіСкопіюйте ключ ще раз або створіть новий; перевірте постачальника й регіон
402Потрібна оплата: закінчилися передплачений баланс чи кредити або є проблема з оплатоюНіПоповніть баланс або виправте спосіб оплати на сторінці оплати постачальника
403Ключ робочий, але дію не дозволено: країна чи регіон не підтримуються, немає доступу до моделі або потрібна верифікаціяНіПеревірте підтримувані регіони, дозволи ключа й вимоги до верифікації
404Неправильна назва моделі або адресаНіВиберіть іншу модель або перевірте адресу
429Забагато запитів за короткий час або, в окремих постачальників, порожній баланс чи ліміт витратЧасто так, якщо це обмеження частотиЗачекайте й повторіть; якщо в повідомленні йдеться про квоту, баланс, кредит чи ліміт витрат, поповніть баланс або збільште ліміт
500–504, 529Збій чи перевантаження на боці постачальникаЗазвичай такСпробуйте пізніше або змініть модель

Чому з’являється помилка про нестачу балансу чи квоти?

Більшості постачальників для роботи API потрібні передплачені кошти або активний спосіб оплати, і кожен повідомляє про порожній баланс по-своєму. Новий ключ тут не допоможе, а поповнення — допоможе.

Нижче — код, який кожен із 15 вбудованих постачальників Oriveo вказує в документації на випадок, коли закінчуються баланс чи кредити. «Не вказано» означає, що в документації постачальника, перевіреній 18 листопада 2026 року, HTTP-коду для цього випадку немає.

Чому з’являється помилка про нестачу балансу чи квоти?
ПостачальникКод, коли закінчився балансЩо в повідомленніОфіційна сторінка
OpenAI429credit_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_errorplatform.claude.com/docs/en/api/errors (коди); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (повідомлення)
Google Gemini402 (передплачена оплата)payment_required; 403 також може означати неоплачений баланс Cloud Billingaistudio.google.com/docs/api-errors
OpenRouter402Вашому акаунту або ключу API бракує кредитівopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI (Grok)Не вказаноКоли передплачені кредити закінчуються, запити відхиляютьсяdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
GroqНе задокументованоGroq виставляє рахунок після використання; на його сторінці помилок немає помилки балансуconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxНе вказано (бізнес-код 1008)insufficient balanceplatform.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)403Arrearage або isv.OUT_OF_SERVICE (заборгованість на акаунті)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.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Що це означаєЩо робити
Збережено, але ключ виглядає недійсним. Ви можете перевірити його пізніше в налаштуваннях постачальника.Oriveo зберіг постачальника, але під час перевірки постачальник відхилив ключСкопіюйте ключ ще раз і оновіть його в налаштуваннях цього постачальника
Недійсний ключ APIПостачальник повернув 401 або 403Перевірте або замініть ключ; у разі 403 перевірте регіон і дозволи
Квоту постачальника вичерпаноПостачальник повідомляє, що кредит чи квоту для цього ключа вичерпано (402 або 429 зі згадкою про квоту)Поповніть баланс у постачальника або перейдіть на іншу модель
Перевищено ліміт запитів (веб) / Постачальник обмежив частоту запитів (iPhone, Android)Наразі забагато запитів (429)Трохи зачекайте й спробуйте знову
Безкоштовну квоту вичерпаноСьогоднішню квоту Oriveo Free використано; до вашого власного ключа це не має стосункуДодайте власний ключ API або дочекайтеся оновлення квоти о 00:00 UTC
Екран «Постачальники» в Oriveo зі списком підключених постачальників, як-от OpenAI, Z.ai, Groq, Gemini та Anthropic, і витратами кожного
Відкрийте постачальника в цьому списку, щоб перевірити або замінити його ключ.

Користуєтеся власною кінцевою точкою, посередницьким сервісом чи шлюзом?

Якщо ви підключаєтеся через власну кінцеву точку, помилка може йти від самого сервісу або від постачальника за ним. Коли Oriveo пише «Це з’єднання не змогло зв’язатися зі своїм постачальником», власний акаунт сервісу в постачальника може бути недійсним, без коштів або з обмеженням частоти запитів. Проблема не у ваших налаштуваннях: перейдіть на інше з’єднання або зверніться до того, хто керує сервісом.

Перевірте це, перш ніж створювати новий ключ

Новий ключ виправляє помилку 401 — і майже нічого більше. Спершу пройдіться цим списком:

  • Ви вибрали правильного постачальника, а для Kimi, MiniMax, Qwen, SiliconFlow і Z.ai — ще й правильний регіон.
  • Ви скопіювали ключ повністю, без пробілів.
  • На акаунті є кошти або активний спосіб оплати.
  • Ваша країна чи регіон є в списку підтримуваних у постачальника.
  • Вибрана модель доступна для вашого акаунта чи рівня.

Поширені запитання

Чому не працює мій ключ API?
Подивіться на номер помилки. 401 — ключ неправильний, 402 — закінчилися баланс чи кредити, 403 — запит не дозволено (часто через регіон чи дозволи), а 429 — забагато запитів або, в окремих постачальників, порожній баланс.
Що означає помилка 401 для ключа API?
Постачальник не розпізнає ключ. Скопіюйте його ще раз без пробілів, перевірте, що він належить вибраним постачальнику й регіону, або створіть новий ключ.
Що таке помилка 402 Payment Required?
Закінчилися передплачений баланс чи кредити або виникла проблема з оплатою. Цей код використовують DeepSeek, OpenRouter, Mistral, Together, Fireworks і передплачена оплата Gemini. Поповніть баланс на сторінці оплати постачальника; очікування не допоможе.
Помилка 429 — це обмеження частоти чи проблема з квотою?
Може бути і те, і те. Зазвичай це обмеження частоти, яке минає після короткого очікування. Але OpenAI, Kimi та Z.ai повертають 429 і тоді, коли баланс порожній, тож якщо в повідомленні йдеться про квоту, баланс чи кредит, поповніть рахунок, а не чекайте.
Чому з ключем API OpenAI з’являється insufficient_quota?
На вашому акаунті OpenAI API не лишилося передплачених коштів. OpenAI повертає 429 з кодом credit_balance_exhausted, а тип помилки може й далі показувати insufficient_quota. Поповніть кредит у налаштуваннях оплати OpenAI; новий ключ не допоможе.
Чому не працює новий ключ API, хоча його скопійовано правильно?
Зазвичай тому, що на акаунті ще немає коштів або не налаштовано оплату, ключ належить іншому регіону чи API недоступний у вашій країні. Перевірте це, перш ніж створювати ще один ключ.

Читайте також

Зрозуміле пояснення помилки для кожного ключа

Відкрийте вебверсію або завантажте Oriveo для iPhone чи Android, додайте ключі 15 постачальників і дізнавайтеся, чому запит не пройшов.

Ще немає ключа API? Почніть з Oriveo Free — ключ не потрібен.