Ошибки OpenRouter: коды 402, 429, 404, 401 и что с ними делать

Большинство сбоев при работе со шлюзом — это не поломка сервиса, а понятный ответ API. Четыре кода закрывают девять случаев из десяти, и лечатся они по-разному: один требует денег, другой — паузы, третий — смены провайдера.

402 — закончился баланс

Самая частая ошибка в продакшене и самая обидная: код работает, запросы уходят, но денег на счёте нет. Сервис не уведомляет заранее, поэтому отслеживать остаток нужно самостоятельно.

Лечится пополнением — инструкция здесь.

Как не попадать в это повторно

• Проверять остаток программно перед запуском длинных задач
• Держать запас, кратный недельному расходу
• Помнить про лимит на ключе: он тоже вызывает эту ошибку при исчерпании

Ошибка при непустом балансе

Значит исчерпан лимит расхода конкретного ключа, а не сам счёт. Лимит меняется в кабинете, деньги при этом никуда не делись.

429 — слишком много запросов

Превышена допустимая частота обращений. Это не блокировка и не наказание: провайдер просит подождать. Ошибка временная и проходит сама.

Правильная реакция — повтор с нарастающей задержкой, а не немедленная повторная отправка: агрессивные ретраи только удлиняют паузу.

Откуда берётся при малом объёме

Лимит считается по провайдеру, а не по вашему аккаунту. Если модель раздаётся провайдером с жёсткими ограничениями, упереться можно и на десятке запросов.

Как обойти без костылей

• Снизить параллельность: три одновременных запроса вместо тридцати
• Добавить задержку между обращениями в цикле
• Указать несколько провайдеров в порядке приоритета

404 — модель недоступна

Модель существует, но конкретный провайдер её сейчас не отдаёт: снял с раздачи, перегружен или изменил название версии.

Названия моделей меняются чаще, чем кажется: после релиза новой версии старый идентификатор какое-то время работает, а потом исчезает.

Что проверить в первую очередь

• Точное написание идентификатора модели — регистр и дефисы важны
• Не устарела ли версия, к которой вы обращаетесь
• Доступна ли модель выбранному провайдеру

Если ошибка из-за пустого баланса

Часть ошибок из списка выше лечится не настройками, а пополнением: лимиты бесплатного уровня заканчиваются быстро.

Ссылки в таблице партнёрские: если вы купите по ним, площадка платит нам комиссию, на цену для вас это не влияет. Порядок — по числу продаж с поправкой на возвраты, а не по размеру комиссии. Данные о продажах берутся из открытого API площадки.

401 — ключ недействителен

Ключ удалён, пересоздан или скопирован с потерей символов. Последнее случается чаще всего: при копировании из терминала теряется часть строки.

Если ключ точно правильный, проверьте, не попал ли он в переменную окружения с лишними пробелами или переводом строки.

Когда стоит просто пересоздать

Если ключ мог засветиться в логах или репозитории — пересоздать дешевле, чем выяснять. Правила хранения — на странице про API-ключ.

Таймауты и медленные ответы

Отдельная категория проблем без кода ошибки: запрос уходит, ответ не приходит или приходит слишком долго. Обычно дело в провайдере, к которому шлюз направил запрос.

Один и тот же запрос к одной и той же модели может выполняться за секунду и за минуту — в зависимости от того, чьи мощности его обслуживают.

Что помогает

• Закрепить конкретного провайдера для критичных задач
• Задать разумный таймаут и повторять запрос вместо бесконечного ожидания
• Для потоковых ответов использовать стриминг: первые токены приходят быстрее

Частые вопросы

Последняя проверка фактов: 13.08.2026. Нашли неточность — напишите редакции.