429 rate_limit_error
429 rate_limit_error в Claude Fable 5
Вы превысили один из трёх поминутных лимитов. Ответ указывает, какой именно; кеширование промптов обычно даёт самый дешёвый выход.
Кратко за 30 секунд
429 — это rate_limit_error. Для Fable 5 действуют три отдельных поминутных ограничения: запросы (RPM), входные токены (ITPM) и выходные токены (OTPM). Лимиты задаются для организации и применяются отдельно к каждой модели, при этом пул Fable 5 значительно меньше, чем у Opus 5. В ответе есть заголовок retry-after и набор заголовков anthropic-ratelimit, которые точно указывают, по какому параметру исчерпан лимит.
Какой лимит вы действительно превысили
Сообщение об ошибке указывает, какой лимит запросов превышен. Прочитайте его, прежде чем что-либо менять.
Лимиты ускорения из-за всплеска трафика
Резкий рост использования в вашей организации может возвращать 429 из-за лимитов ускорения, даже если вы не превышаете опубликованные показатели тарифа. Наращивайте трафик постепенно и поддерживайте стабильный профиль использования вместо запуска новой нагрузки сразу на полной мощности.
Входные токены в минуту
Этот лимит пользователи Fable 5 превышают чаще всего: на Start доступно 500,000 ITPM против 2,000,000 у Opus 5, а контекстное окно Fable 5 на 1M токенов располагает к очень большим промптам. Учитывается только некешированный ввод: input_tokens плюс cache_creation_input_tokens. Чтения из кеша не учитываются.
Выходные токены в минуту
Fable 5 допускает 100,000 OTPM на Start, 300,000 на Build и 800,000 на Scale. OTPM оценивается в реальном времени по фактически сгенерированным токенам, поэтому max_tokens не влияет на расчёт. Долгие автономные запуски Fable 5 с высоким effort исчерпывают этот лимит быстрее, чем более короткие обращения к другим моделям.
Запросы в минуту
Fable 5 допускает 1,000 RPM на тарифе Start, 2,000 на Build и 4,000 на Scale. Ограничитель использует token bucket с непрерывным пополнением, а не сбрасывается по фиксированному времени: всплеск может исчерпать минутный запас за секунду и вызвать 429, даже если средняя скорость намного ниже лимита.
Запрос отправлен с неверными учётными данными
Лимиты применяются на уровне организации, при этом для рабочего пространства могут быть заданы более низкие ограничения. Случайный ANTHROPIC_API_KEY в окружении может направить трафик через ключ низкого тарифа вместо ожидаемого аккаунта, и тогда вы упрётесь в лимит этого ключа, а не своего аккаунта.
Исправляйте в таком порядке
Сначала изучите ответ, затем снизьте нагрузку и только потом просите больше мощности. Запрос на повышение лимита до настройки кеширования обычно даёт меньший эффект, чем само кеширование.
- 1
3. Кешируйте повторяющуюся часть промпта
Для большинства моделей cache_read_input_tokens не учитываются в ITPM. При лимите 2,000,000 ITPM и доле попаданий в кеш 80 процентов вы можете обрабатывать 10,000,000 входных токенов в минуту. Кешируйте системные инструкции, определения инструментов, большие документы и историю диалога.
- 2
4. Снизьте параллелизм у источника
В своём клиенте ограничьте число запросов в обработке и ставьте остальные в очередь вместо веерной отправки. В Claude Code уменьшите CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, который по умолчанию равен 10, не запускайте много параллельных субагентов и для высоконагруженных скриптовых запусков переключитесь на меньшую модель через /model.
- 3
2. Определите ограничивающий параметр по заголовкам ответа
Проверьте anthropic-ratelimit-requests-remaining, anthropic-ratelimit-input-tokens-remaining и anthropic-ratelimit-output-tokens-remaining, а также соответствующие им заголовки limit и reset. Оптимизация не того параметра — самая частая напрасная трата усилий в этой ситуации.
- 4
1. Ждите ровно столько, сколько указано в retry-after
Заголовок retry-after содержит число секунд до следующей попытки. Повторные запросы раньше этого срока по определению завершатся неудачей, поэтому считайте это значение нижней границей, а для парка воркеров добавляйте к нему случайную задержку.
- 5
5. Запросите более высокий лимит с реальными цифрами
На странице Limits в Claude Console используйте Request rate limit increase. Укажите пиковое число входных и выходных токенов в минуту для каждой модели и примерную долю закешированного или повторяющегося контекста: именно по этим данным оценивается форма запроса.
Посмотрите фактические лимиты
Поминутные значения RPM, ITPM и OTPM Fable 5 для каждого тарифа, влияние чтений из кеша на расчёт и переходы между тарифами.