Ошибки и отказы/Коды ошибок

Коды ошибок и устранение неполадок

Как по HTTP-статусу отличить ошибки авторизации, баланса, ограничения частоты, недоступности и таймаута апстрима и что делать в каждом случае.

На этой страницеexpand_more
401

invalid api key

Ключ отсутствует, указан с ошибкой, удалён, либо заголовки Authorization / x-api-key противоречат друг другу.

402

insufficient balance

Недостаточно средств на балансе. Пополните баланс, чтобы продолжить отправлять запросы.

429

rate limited

Слишком частые запросы. Повторите позже или снизьте параллелизм.

502

upstream unavailable

Сервис модели на стороне апстрима временно недоступен. Переключитесь на другую модель или повторите позже.

504

upstream timeout

Истекло время ожидания ответа апстрима. Сократите контекст, уменьшите max_tokens или повторите запрос.

529

upstream overloaded

Модель на стороне апстрима временно перегружена; Wokey уже повторил запрос по другим маршрутам (code upstream_unavailable). С вашим балансом это не связано. Повторите чуть позже или переключитесь на другую модель.

Как распознать отказ моделиarrow_forwardКогда модель Claude отказывает, Wokey передаёт сообщение об отказе от Anthropic без изменений. Downstream-платформы могут распознавать отказы по полям ниже и применять свои меры контроля рисков.