Код 429 с текстом Too many requests возвращают несколько разных ограничений. Текст ошибки у них одинаковый, поэтому причину проще определить по тому, что происходило перед ней.
Если по одному ключу за минуту приходит 20 ответов с ошибкой 4xx, ключ переводится в паузу, и все запросы по нему получают 429. Первая пауза — минута, при повторении — 10 минут, затем час, затем 12 часов. Отсчёт повторов обнуляется через 12 часов без новых срабатываний.
Смысл ограничения в том, что поток ошибок почти всегда означает неверную интеграцию, а не временный сбой: повторять такие запросы бессмысленно.
Считаются все ошибки 4xx, а не только отказы по лимитам. Два типичных сценария:
- В теле запроса опечатка, и сервис отвечает 400. Приложение в цикле отправляет его снова — на двадцатом ответе ключ уходит в паузу.
- На балансе не хватает средств, каждый запрос возвращает 402. Двадцать таких ответов за минуту дают тот же результат: до конца паузы вместо 402 будет приходить 429, даже если баланс уже пополнен.
Прежде чем повторять запрос, стоит разобраться с причиной ошибки. Циклические повторы неудачного запроса приводят к паузе по ключу.
Пропускную способность на стороне конечного сервиса задают два предела: на количество запросов в минуту и на количество токенов в минуту. Точные значения у каждой модели свои, где-то выше, где-то ниже, но порядок один и тот же — десятки тысяч запросов и миллионы токенов. Запросы ProxyAPI идут через пул аккаунтов на максимальных тарифных уровнях, поэтому на обычной нагрузке упереться в эти пределы практически невозможно.
Если 429 всё же пришла от конечного сервиса, причина обычно не в исчерпанном лимите, а в перегрузке или сбое на его стороне. Такие ошибки временные: запрос сначала пробуется у другого провайдера этой модели, и приложению возвращается только если не ответил ни один.
Если нагрузка требует гарантированно большей пропускной способности, напишите в поддержку — расширить канал можно для любой модели.
При 429 запрос стоит повторить с увеличивающейся задержкой: одна секунда, две, четыре и так далее. Повторы без задержки только продлевают ограничение.
Ошибки 4xx, кроме 429, повторять не нужно вообще: их причина в самом запросе, и серия повторов приведёт к паузе по ключу.
- Ошибки и коды ответов — что означают остальные коды.
- API-ключи — ограничения, которые задаются для ключа.
Частые вопросы
Почему запрос возвращает 429, хотя запросов немного?
Скорее всего сработала пауза после серии ошибок: 20 ответов с ошибкой 4xx за минуту по одному ключу переводят ключ в паузу. Проверьте, не повторяется ли в коде запрос, который возвращает ошибку.
Как долго длится пауза по ключу?
Первая — минуту. При повторении — 10 минут, затем час, затем 12 часов. Если срабатываний нет 12 часов, отсчёт начинается заново.
Есть ли ограничение на количество запросов и токенов в минуту?
Пределов два, и задаёт их конечный сервис: на запросы в минуту и на токены в минуту. У каждой модели значения свои, но порядок везде одинаковый — десятки тысяч запросов и миллионы токенов. Запросы распределяются по пулу аккаунтов на максимальных тарифных уровнях, так что на обычной нагрузке эти пределы недостижимы. Если нужна гарантированно большая пропускная способность — напишите в поддержку.
Что делать при ошибке 429?
Повторить запрос с увеличивающейся задержкой — одна секунда, две, четыре. Остальные ошибки 4xx повторять не нужно: их причина в самом запросе.
Последняя редакция: 2 сентября 2026 г.