Rate limit exceeded: что значит и когда сбросится
Главный вопрос по этой надписи не «что это», а «сколько ждать», и почти все статьи отвечают на него наугад. Между тем точное время присылает сам сервер в заголовке ответа, и я разобрал по документации, где его смотреть, когда его там не будет и почему ожидание до начала часа это миф.
Короткий ответ
Rate limit exceeded это ответ сервера с кодом 429: запросов или токенов за единицу времени оказалось больше разрешённого. Это не блокировка аккаунта, не поломка и обычно не ваша вина как программиста. Доступ вернётся сам.
Время ожидания сервер сообщает сам: в ответе приходит заголовок retry-after с числом секунд, и повторять раньше бессмысленно, такие попытки просто не проходят. Если этого заголовка в ответе нет, значит дело не в частоте: у Anthropic, например, при исчерпанном месячном потолке расходов приходит тот же тип ошибки, но без retry-after, и доступ возвращается только в начале следующего месяца по всемирному времени.
Главное в одну строку
Смотрите retry-after: есть он, значит ждать секунды или минуты; нет его, значит кончились не запросы, а деньги или квота.
Смысл
Что именно говорит сервер этой надписью
Код 429 в протоколе означает «слишком много запросов». Сервис ограничивает не общее количество работы, а её плотность во времени, и измеряется это обычно тремя вещами: запросами в минуту, входными токенами в минуту и исходящими токенами в минуту, причём отдельно для каждого класса моделей. В ответе сервис пишет, какой именно предел вы пробили.
Поэтому первая мысль «у меня кончилась подписка» почти всегда неверна. Подписка кончается другой ошибкой, доступ закрывается третьей, а 429 означает ровно одно: притормозите. Как устроены лимиты подписок у чатов и чем они отличаются от лимитов интерфейса, разобрано в гайде про лимиты нейросетей.
Главное
Когда сбросится: три разных случая
| Что видно в ответе | Что это значит | Сколько ждать |
|---|---|---|
| 429 и заголовок retry-after | Обычный предел частоты | Ровно столько секунд, сколько в заголовке |
| 429 без retry-after | Исчерпан денежный потолок аккаунта | До начала следующего месяца по всемирному времени или до повышения лимита |
| 429 с кодом про суточную квоту | Кончился дневной объём, а не частота | До сброса квоты или до её увеличения по запросу |
Эти три случая лечатся по-разному, и именно поэтому универсальный совет «подожди час и попробуй снова» работает только в первом. Во втором ожидание бесполезно, в третьем час может не помочь.
Где смотреть
Заголовки ответа, которые всё объясняют
Это самая полезная часть, и её почти никто не читает. Вместе с ошибкой приходят служебные заголовки, по которым видно и остаток, и время восстановления. Ниже набор из документации Anthropic, снятой 10 октября 2026 года, и он показателен для остальных сервисов.
| Заголовок | Что в нём |
|---|---|
| retry-after | Число секунд до повтора. Более ранние попытки не пройдут. Не присылается при упоре в денежный потолок |
| Предел запросов | Максимум запросов за период ограничения |
| Остаток запросов | Сколько запросов ещё можно сделать до ограничения |
| Время восстановления запросов | Момент, когда предел запросов пополнится полностью, в стандартном формате даты и времени |
| Пределы и остатки по токенам | То же самое отдельно для токенов, входных токенов и исходящих токенов, с округлением остатка до тысяч |
Что с этим делать, если вы не программист
Если вы работаете в чате или в редакторе кода, заголовков вы не увидите, их видит программа. Но вывод из них всё равно практичный: интерфейс обычно показывает время сброса сам, и именно ему стоит верить, а не советам из статей. Если время не показано, ориентир простой: при обычном лимите частоты пауза измеряется секундами и минутами, а не часами.
Механика
Почему ждать начала часа бессмысленно
В документации Anthropic это сказано дословно: используется алгоритм текущего ведра, то есть ваш запас непрерывно пополняется до максимума, а не обнуляется через фиксированные интервалы. Представьте ведро с водой, из которого вы черпаете, и тонкую струйку, которая его всё время наполняет.
- Запас возвращается постепенно, а не разом в начале минуты или часа.
- Короткая пауза часто решает дело: после неё часть запаса уже есть.
- Резкий всплеск после паузы снова пробьёт предел, потому что ведро наполнено ещё не до краёв.
- Плавный темп выгоднее рывков: при равномерной нагрузке вы просто не упираетесь.
Отсюда и правильная стратегия повторов: не «ждать до круглого времени», а наращивать паузу и выравнивать темп. Это ровно то, что советуют в руководствах по устранению неполадок у разных вендоров.
Важный случай
429 без retry-after: это кончились не запросы, а деньги
Отдельный и самый коварный случай. По документации Anthropic при достижении потолка расходов вашего уровня использование интерфейса приостанавливается до начала следующего месяца по всемирному времени, если раньше не запросить повышение лимита. Пока пауза действует, запросы возвращают тот же код 429 и тот же тип ошибки, что и обычный лимит частоты.
Как отличить и почему это важно
Отличие одно: в этом ответе нет заголовка retry-after. И документация прямо предупреждает, что повторы, включая автоматические повторы официальных библиотек, будут падать, пока доступ не вернётся. То есть ваш код в этот момент может часами молотить повторы впустую, а в логах будет видна обычная ошибка лимита. Если 429 идёт подряд и без retry-after, проверяйте не частоту, а биллинг.
Полезная деталь из той же документации: в тексте такой ошибки сервис обычно сам пишет дату, когда доступ вернётся. Ещё одно место, где стоит читать сообщение целиком, а не только его начало.
Разница
Частота против квоты: один код, два смысла
В справочнике ошибок Gemini это разведено явно: при одном и том же статусе 429 текстовые коды разные. Один означает превышение лимита запросов или токенов в минуту, второй исчерпание суточной квоты, третий просто слишком много запросов за короткий промежуток. Рекомендации к ним тоже разные: первому и третьему пауза с экспоненциальной задержкой, второму дождаться сброса квоты или запросить увеличение.
| Тип предела | Горизонт | Что помогает |
|---|---|---|
| Частота | Секунды и минуты | Пауза, выравнивание темпа |
| Суточная квота | День | Ждать сброса, просить увеличение, уйти на другой уровень |
| Денежный потолок | Месяц | Повысить лимит расходов или ждать нового месяца |
| Предел одновременных запросов | Мгновение | Уменьшить параллельность, ставить задачи в очередь |
Последняя строка часто оказывается настоящей причиной при пакетной обработке. Для примера: в документации DeepSeek предел одновременных запросов указан как 2500 для младшей модели и 500 для старшей, и при разборе тысяч документов упираются именно в него, а не в минутные лимиты. Разбор этих моделей и их цен в гайде про DeepSeek V4.
Причины
Почему прилетает, когда вы ничего не меняли
- Защита от резкого роста нагрузки. В документации Anthropic это названо ограничением ускорения: если у организации резкий всплеск использования, можно получить 429 даже в пределах обычных лимитов. Совет оттуда же: наращивать трафик плавно и держать ровный профиль нагрузки.
- Лимит считается на организацию, а не на человека. Коллега, запустивший пакетную задачу, съедает ваш запас.
- Отдельные пространства считаются отдельно. У Anthropic лимиты рабочего пространства агента проверяются обособленно, и запросы сверх него получают свой 429 с заголовком времени ожидания.
- У особых режимов свои лимиты. Там же: у быстрого режима старших моделей отдельные лимиты, не связанные со стандартными, и при их превышении приходит тот же 429.
- Бесплатный уровень режут первым. На странице состояния Google AI Studio это написано открыто: запросы бесплатного уровня идут по сбрасываемой мощности, а оплаченные защищены критическим приоритетом.
Для разработчика
Как обрабатывать 429 в коде
- Читайте retry-after и ждите указанное время, а не своё.
- Экспоненциальная задержка: секунда, две, четыре, восемь.
- Случайный разброс к паузе, чтобы клиенты не повторяли синхронно.
- Повторять только временные ошибки: 429, 408 и любые 5xx.
- Не повторять 400, 402 и 403: неверный запрос, кончившиеся средства, нет прав.
- Ставить предел попыток, иначе цикл повторов добивает сервис и ваш бюджет.
- Логировать отсутствие retry-after отдельным событием: это сигнал про потолок расходов, а не про частоту.
Официальные библиотеки часть этого делают сами: например питоновская библиотека Gemini повторяет временные ошибки до четырёх раз с начальной задержкой около секунды и максимальной в минуту. Но полагаться на это полностью нельзя: при упоре в денежный потолок автоматические повторы только жгут время.
Практика
Почему агенты и редакторы кода ловят лимит чаще
Причина арифметическая. На одну вашу задачу агент делает десятки обращений: читает файлы, пробует, проверяет результат, исправляет. Чат делает одно обращение на сообщение. Поэтому в редакторе или консольном агенте лимит ловится в разы быстрее, особенно на бесплатных уровнях.
- Сократите контекст: не кладите весь проект, если задача про один файл.
- Включите кэш контекста, где он есть: повторная подача того же текста стоит копейки.
- Переносите тяжёлое в пакетный или асинхронный режим, если ответ не нужен сию секунду: у части сервисов это ещё и вдвое дешевле.
- Не запускайте несколько агентов на одном ключе параллельно: они делят один лимит.
- Выбирайте модель под задачу: младшая модель на простых шагах расходует запас куда медленнее.
Подробный разбор экономии в гайде про экономию токенов, а про лимиты конкретных агентов в гайдах про лимиты Codex и лимиты ChatGPT.
Рамка
Если надпись пришла не от ИИ-сервиса
Эта надпись встречается далеко за пределами нейросетей: её показывают почтовые серверы, игры, маркетплейсы, соцсети и любые интерфейсы, потому что код 429 часть общего протокола. Механика везде одинаковая: сервер ограничивает частоту обращений и просит притормозить.
Что меняется: конкретные окна, числа и способ узнать время сброса задаёт тот сервис, который вам ответил. Поэтому искать стоит лимиты именно его интерфейса, а не общий ответ. Эта страница разбирает случай ИИ-сервисов, и если надпись пришла из игры или из почты, из неё вам полезны только два пункта: смотреть retry-after и не повторять запрос в цикле.
Памятка
Что запомнить про Rate limit exceeded
Коротко
- Это код 429: слишком много запросов или токенов за единицу времени.
- Не блокировка и не поломка, доступ вернётся сам.
- Время ожидания приходит в заголовке retry-after, в секундах.
- Раньше указанного времени повторять бессмысленно.
- Нет retry-after, значит упёрлись в денежный потолок аккаунта.
- В этом случае доступ вернётся в начале месяца по всемирному времени.
- Автоматические повторы библиотек при потолке расходов бесполезны.
- Запас пополняется непрерывно, а не обнуляется по часам.
- Частота лечится паузой, суточная квота ожиданием или повышением.
- Предел одновременных запросов это отдельная причина при пакетах.
- Резкий всплеск нагрузки ловит защиту даже в пределах лимитов.
- Лимит обычно считается на организацию, а не на человека.
- Повторять стоит 429, 408 и 5xx, не стоит 400, 402 и 403.
- Агенты ловят лимит чаще чатов, потому что делают десятки запросов.
- Второй аккаунт не выход: это нарушение условий.
FAQ
Частые вопросы
Что значит надпись Rate limit exceeded
Это ответ сервера с кодом 429: вы отправили больше запросов или токенов, чем разрешено за единицу времени. Переводится как «превышен предел частоты». Важно, что это не блокировка аккаунта и не поломка: доступ вернётся сам, вопрос только в том, когда именно. Ни подписка, ни пароль, ни ваш код тут обычно не виноваты.
Когда сбросится лимит
Точный ответ даёт сам сервер, а не статья. В ответе с кодом 429 приходит заголовок retry-after с числом секунд, и это время ожидания: более ранние повторы просто не пройдут. У Anthropic рядом приходят ещё и заголовки с остатком запросов и токенов и со временем полного восстановления в стандартном формате даты. Если заголовка нет вовсе, причина другая, и про неё ниже.
Почему лимит не сбрасывается ровно через час
Потому что у многих сервисов он не привязан к фиксированным интервалам. В документации Anthropic это сказано прямо: используется алгоритм текущего ведра, то есть ваш запас непрерывно пополняется до максимума, а не обнуляется по расписанию. Отсюда практичное следствие: ждать «до начала часа» бессмысленно, обычно достаточно паузы в секунды или минуты, и доступ возвращается постепенно.
Пришёл 429, но заголовка retry-after нет, что это
Скорее всего это не частота, а исчерпанный денежный потолок. У Anthropic при достижении месячного предела расходов тип ошибки остаётся тем же, но заголовка retry-after в ответе нет, и доступ возобновляется только в начале следующего месяца по всемирному времени либо после повышения лимита. Повторы, включая автоматические повторы официальных библиотек, в этом случае бесполезны: они будут падать, пока доступ не вернут.
Как правильно обрабатывать 429 в коде
Экспоненциальной задержкой со случайным разбросом: подождать секунду, потом две, четыре, восемь, добавляя небольшое случайное смещение, чтобы все клиенты не ломились в одну секунду. Повторять стоит 429, 408 и любые 5xx. Не стоит повторять 400, 402 и 403: это неверный запрос, кончившиеся деньги и отсутствие прав. И обязательно ставьте предел числа попыток, иначе получается цикл, который сам себя душит.
В чём разница между лимитом частоты и квотой
Лимит частоты это сколько можно за минуту, квота это сколько можно за сутки или месяц. У Gemini они даже кодируются разными текстовыми кодами при одном и том же статусе 429: превышение частоты и превышение суточной квоты. Лечатся они по-разному: частота проходит после паузы, квота требует дождаться сброса или запросить увеличение.
Почему 429 приходит, хотя я ничего не менял
Три частые причины. Первая: защита от резкого роста нагрузки, у Anthropic это названо ограничением ускорения, и чтобы не попадать под него, трафик наращивают плавно. Вторая: предел одновременных запросов, у DeepSeek, например, 2500 у младшей модели и 500 у старшей, и при пакетной обработке упираются именно в него. Третья: лимит считается не только на вас, а на весь аккаунт или рабочее пространство.
Как не ловить лимит в агенте или редакторе кода
Главное правило: агент делает десятки запросов на одну задачу, потому что читает файлы, пробует и исправляет. Поэтому в редакторах и консольных агентах лимит ловится быстрее, чем в чате, особенно на бесплатных уровнях. Что помогает: держать запрос короче, пользоваться кэшем контекста, переносить тяжёлые пакетные задачи в асинхронный или пакетный режим, где он есть, и не запускать несколько агентов параллельно на одном ключе.
Это только про ИИ-сервисы или надпись бывает где угодно
Надпись стандартная для всего интернета: её показывают почтовые сервисы, игры, маркетплейсы и соцсети, потому что код 429 часть протокола. Механика везде одна: сервер ограничивает частоту обращений. Но конкретные числа, окна и способы узнать время сброса задаёт тот сервис, который вам ответил, поэтому искать надо лимиты именно его интерфейса. Эта страница про ИИ-сервисы.
Можно ли обойти лимит вторым аккаунтом
Нет, и это плохая идея по двум причинам. Первая: условия сервисов прямо запрещают обход ограничений и передачу доступа, и заканчивается это ограничением всех аккаунтов разом. Вторая: обычно проблема не в потолке, а в способе работы, и дешевле починить его: сократить контекст, включить кэш, перейти в пакетный режим или взять тариф с нужным объёмом.
Читать дальше
Платформа и сообщество, где я по шагам показываю, как поставить ИИ на рутину: контент, код, продажи, аналитика. Заходи и забирай рабочие связки, которыми пользуюсь сам.
Посмотреть, что внутриtelegram
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.
