API key не работает: разбор ошибок

Не работает 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 Key» или «Квота провайдера исчерпана»; они разобраны ниже на этой странице.

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

Начните отсюда: найдите свой номер и прочитайте соответствующий раздел ниже. Сводка составлена по страницам ошибок OpenAI, Anthropic и других провайдеров на 18 ноября 2026 года.

Коротко: 401, 402, 403, 429 и 5xx
КодЧто обычно значитПройдёт ли само?Что делать
401Ключ неверный: не хватает символа, лишний пробел, ключ удалён или он от другого провайдера либо регионаНетСкопируйте ключ заново или создайте новый; проверьте провайдера и регион
402Нужна оплата: закончились предоплаченный баланс или кредиты либо возникла проблема с оплатойНетПополните баланс или исправьте способ оплаты на странице оплаты провайдера
403Ключ рабочий, но действие не разрешено: страна или регион не поддерживаются, нет доступа к модели или нужна проверка (верификация)НетПроверьте список поддерживаемых регионов, права ключа и требования к верификации
404Неверное название модели или адресНетВыберите другую модель или проверьте адрес
429Слишком много запросов за короткое время, а у некоторых провайдеров — пустой баланс или лимит тратЧасто, если это лимит запросовПодождите и повторите; если в сообщении упоминаются quota, balance, credit или spend limit, пополните баланс или поднимите лимит
500–504, 529Сбой или перегрузка на стороне провайдераОбычно даПовторите позже или смените модель

Почему пишет insufficient balance или quota

Большинству провайдеров для работы API нужны предоплаченные кредиты или подключённый способ оплаты, и о пустом балансе каждый сообщает по-своему. Новый ключ ни в одном из этих случаев не поможет — поможет пополнение.

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

Почему пишет insufficient balance или quota
ПровайдерКод при пустом балансеЧто в сообщенииОфициальная страница
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-ключа недостаточно кредитов (insufficient credits)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, если ключу недоступен ресурс; проверьте настройки организации и рабочего пространства (workspace).
  • 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 KeyПровайдер вернул 401 или 403Проверьте или замените ключ; при 403 проверьте регион и права доступа
Квота провайдера исчерпанаПровайдер сообщает, что кредиты или квота этого ключа израсходованы (402 или 429 с упоминанием квоты)Пополните баланс у провайдера или переключитесь на другую модель
Ограниченная ставка (веб) / Провайдер ограничил частоту запросов (iPhone и Android)Сейчас слишком много запросов (429)Подождите немного и повторите
Бесплатная квота исчерпана (на Android — «Квота Free исчерпана»)Дневной лимит Oriveo Free на сегодня израсходован; к вашему собственному ключу это отношения не имеетДобавьте свой API-ключ или дождитесь обновления лимита в 00:00 UTC
Экран «Провайдеры» в Oriveo со списком подключённых провайдеров — OpenAI, Z.ai, Groq, Gemini, Anthropic — и примерными расходами по каждому
Откройте провайдера из этого списка, чтобы проверить или заменить его ключ.

Подключаетесь через свой эндпоинт, ретранслятор или шлюз?

Если вы подключаетесь через собственный адрес API (custom endpoint), ошибка может исходить от этого сервиса или от провайдера, который стоит за ним. Когда 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 и при пустом балансе, так что если в сообщении есть quota, balance или credit, не ждите, а пополните баланс.
Почему ключ OpenAI пишет insufficient_quota?
На вашем API-аккаунте OpenAI закончились предоплаченные кредиты. OpenAI возвращает 429 с кодом credit_balance_exhausted, а тип ошибки может по-прежнему называться insufficient_quota. Пополните баланс в настройках оплаты OpenAI; новый ключ не поможет.
Почему новый API-ключ не работает, хотя скопирован правильно?
Обычно потому, что на аккаунте ещё нет кредитов или не настроена оплата, ключ относится к другому региону или API не предоставляется в вашей стране. Проверьте это, прежде чем создавать ещё один ключ.

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

Из блога

Понятные ошибки для каждого ключа

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

Ещё нет API-ключа? Начните с Oriveo Free.