Ошибки

Ошибки платформы приходят с HTTP-статусом и JSON одного вида:


{"error": {"code": "insufficient_balance", "message": "insufficient balance, please top up"}}

code — машинный код из таблиц ниже, на него стоит опираться в коде клиента. message — пояснение на английском, его текст может меняться.

Если запрос дошёл до модели, а модель или её провайдер ответили ошибкой, клиент получает этот ответ с его статусом и телом.

Запрос

Статус и код	Причина	Что делать
`400 invalid_request`	тело не JSON-объект, неверное поле или функция, которая не поддерживается (см. Модели и цены)	исправить запрос по `message`
`400 unsupported_endpoint`	`POST /v1/messages` с моделью не от Anthropic	вызвать модель через `/v1/chat/completions`
`404 model_not_found`	модели с таким `id` нет в каталоге	взять `id` из `GET /v1/models`
`413 request_too_large`	тело запроса больше 32 МБ	уменьшить запрос

Доступ

Статус и код	Причина	Что делать
`401 invalid_api_key`	ключа нет в запросе, он неизвестен, отозван или истёк	проверить ключ (см. Аутентификация)
`403 endpoint_not_allowed`	эндпоинт не разрешён ключу	выбрать другой ключ или создать новый
`403 model_not_allowed`	модель не разрешена ключу	то же
`403 ip_not_allowed`	запрос пришёл с IP-адреса вне списка ключа	то же
`403 account_suspended`	аккаунт заблокирован	—
`403 account_deleted`	аккаунт удалён	—

Баланс и лимиты

Статус и код	Причина	Что делать
`402 insufficient_balance`	на балансе не хватает средств на резерв запроса	пополнить баланс или уменьшить `max_tokens`
`429 rate_limit_exceeded`	превышен лимит запросов в минуту	повторить через `Retry-After`
`429 too_many_concurrent_requests`	слишком много одновременных запросов аккаунта	повторить через `Retry-After`
`429 spend_limit_exceeded`	исчерпан лимит расхода ключа за сутки или месяц	дождаться сброса (`Retry-After`) или поднять лимит в кабинете

Подробнее — в разделе Лимиты.

Сбои

Статус и код	Причина	Что делать
`500 internal_error`	внутренняя ошибка платформы	повторить позже
`502 upstream_unavailable`	модель недоступна	повторить запрос
`502 empty_response`	модель вернула пустой ответ; он не оплачивается	повторить запрос или выбрать другую модель
`503 busy`	слишком много больших запросов одновременно	повторить через `Retry-After`
`503 shutting_down`	сервер перезапускается	повторить через `Retry-After`
`504 upstream_timeout`	модель не ответила вовремя	повторить запрос

При 503 shutting_down, 504 и при обрыве соединения клиентом модель могла уже прочитать запрос: у такого запроса оплачивается только вход — сначала по оценке, затем она уточняется по данным модели.