Устранение неполадок
Справочник ошибок Claude Fable 5
Пять типов сбоев охватывают почти все проблемы интеграции Fable 5. Найдите свой по коду статуса и выполните шаги по порядку.
Кратко за 30 секунд
529 означает нехватку мощности у Anthropic, и запрос нужно повторить. 429 означает, что ваш поток запросов упёрся в собственный пул лимитов Fable 5, который меньше пулов Opus и Sonnet. 400 связан с вашим payload или настройкой хранения данных в организации. Отказ вообще не является ошибкой: он приходит как HTTP 200 со значением refusal в stop_reason, поэтому исключение не возникает. 404 означает неверный ID модели или отсутствие доступа к claude-fable-5 у вашей учётной записи.
529 overloaded_error
Платформа Anthropic исчерпала доступную мощность для всех клиентов. Это не связано ни с вашей учётной записью, ни с квотой и не исправляется с вашей стороны ничем, кроме задержки перед повтором.
429 rate_limit_error
Вы превысили лимит запросов, входных или выходных токенов в минуту в собственном пуле Fable 5. Заголовок retry-after точно указывает, сколько нужно ждать.
400 invalid_request_error
Обычно это параметр, который Fable 5 больше не поддерживает, например temperature или бюджет thinking, либо настройка хранения данных в организации меньше требуемых 30 дней.
stop_reason: refusal
Классификатор безопасности отклонил запрос и вернул HTTP 200. Проверьте stop_details.category, чтобы узнать, в какой области политики сработало ограничение.
404 not_found_error
ID модели указан неверно либо claude-fable-5 недоступна для вашей учётной записи, рабочего пространства, тарифа или версии Claude Code.
Лимиты запросов Fable 5
Значения RPM, ITPM и OTPM для каждого уровня использования, влияние чтения из кэша на расчёт и порядок увеличения лимита.
Почему сбои Fable 5 отличаются
Четыре архитектурных различия объясняют большинство неожиданностей при переносе интеграции с Opus 4.8 или Opus 5.
Отказы считаются успешными ответами
Fable 5 использует классификаторы безопасности, которые могут отклонить запрос. При отклонении возвращаются HTTP 200, значение refusal в stop_reason и объект stop_details. Панели мониторинга ошибок и блоки try/except этого не увидят, поэтому в production отказ обычно выглядит как пустой ответ, а не как оповещение.
Допустимых параметров стало меньше
Значения temperature, top_p и top_k, отличные от значений по умолчанию, возвращают 400. Предзаполнение ответа ассистента также возвращает 400. Как thinking.type со значением disabled, так и вручную заданное значение budget_tokens возвращают 400. Типы запросов SDK по-прежнему содержат эти поля для обратной совместимости, поэтому код проходит проверку типов, но API отклоняет его во время выполнения.
У Fable 5 собственный пул лимитов запросов
Лимиты запросов применяются отдельно к каждой модели, и пул Fable 5 значительно меньше, чем у Opus 5. На уровне Start Fable 5 допускает 500,000 входных токенов в минуту и 100,000 выходных токенов в минуту, тогда как Opus 5 — 2,000,000 и 400,000. Трафик, который не получал 429 на Opus, может сразу получить его на Fable 5.
Некоторые 400 и 404 связаны с организацией, а не с запросом
Fable 5 требует хранения данных в течение 30 дней и недоступна при нулевом хранении данных. Организация, чьи настройки хранения не отвечают этому требованию, получает 400 на каждый запрос независимо от содержимого payload. Список разрешённых моделей, заданный администратором, даёт тот же эффект: доступ либо есть для всех запросов, либо отсутствует для всех.
Исправляйте в таком порядке
Прежде чем добавлять повторы, определите тип сбоя. Повтор не того типа ошибки либо тратит деньги, либо скрывает ошибку конфигурации.
1. Проверьте код статуса и тип ошибки
Каждое тело ошибки API содержит error.type и request_id. Для 429 это rate_limit_error, для 529 — overloaded_error, для 400 — invalid_request_error, для 404 — not_found_error. Сохраняйте request_id: это единственный идентификатор, по которому служба поддержки Anthropic может разобраться в запросе.
3. Учитывайте retry-after и используйте экспоненциальную задержку
Повторяйте запросы при 429, 500, 504 и 529 с экспоненциальной задержкой и ждите не меньше числа секунд из заголовка retry-after. Более ранняя повторная попытка заведомо завершится неудачей. Не повторяйте 400, 401, 403 и 404: тот же запрос снова завершится тем же сбоем.
2. Проверяйте stop_reason для каждого ответа 200
Проверяйте, равно ли stop_reason значению refusal, прежде чем читать content. Не определяйте отказ по пустому массиву content и не разбирайте stop_details.explanation: формулировка этого поля не является стабильной. И category, и explanation могут быть null при корректном отказе.
4. Настройте резервную модель и проверьте переключение
Серверный параметр fallbacks срабатывает только при отклонении запроса классификатором безопасности. 429, 529 или 500 от Fable 5 возвращаются без изменений, поэтому резервирование при нехватке мощности вам нужно реализовать в своём коде.
Исправьте именно тот сбой, который возник у вас
Начните с кода статуса. На каждой странице разобраны причина, порядок исправления и самые частые вопросы разработчиков о конкретном сбое.