Работа с API

Коды

• 400 — тело запроса не является корректным JSON или модель отклонила запрос (причина — в message).
• 400 — в теле повторяется ключ или ключ отличается от поля запроса только регистром букв (например, Model вместо model): имена полей чувствительны к регистру.
• 401 — ключ не передан, неверен, отключён или удалён.
• 402 — недостаточно средств на балансе или исчерпан лимит расхода ключа (insufficient_balance).
• 403 — аккаунт деактивирован (account_deactivated) или email не подтверждён (email_not_verified).
• 404 — модель не найдена (model_not_found) или нет такой видеозадачи.
• 409 — запрос с тем же Idempotency-Key ещё выполняется.
• 413 — тело запроса больше 16 МБ (аудиофайл для распознавания — больше 25 МБ).
• 422 — запрос нельзя выполнить; причина — в code (см. ниже).
• 429 — слишком много одновременных запросов, повторите через Retry-After (см. «Лимиты и повторы»).
• 502, 503 — временная недоступность: запрос не выполнен и не тарифицируется, повторите его позже.
• 500 — внутренняя ошибка, повторите запрос позже.

Коды 422

• model_unavailable — модель сейчас недоступна.
• unsupported_model — модель не поддерживается.
• wrong_endpoint — модель не подходит для этого эндпоинта (например, эмбеддинговая модель в чате).
• invalid_max_tokens — max_tokens не положительный, больше допустимого для модели или не передан там, где обязателен.
• unsupported_modality — модель не принимает такой вход или не выдаёт такой результат.
• server_tools — серверные инструменты в Anthropic Messages.
• idempotency_key_reuse — Idempotency-Key уже использован с другим телом запроса.

{
  "error": {
    "message": "Insufficient balance or key limit to serve this request.",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  }
}

Разбор в кабинете

Ошибку, которую вернула сама модель (например, на неподдерживаемый параметр), шлюз передаёт с её статусом — 400, 404, 413 или 422: поле code у такой ошибки не заполнено, причина — в message. Такой запрос не тарифицируется.

Каждый запрос — с моделью, статусом, токенами и стоимостью — виден в разделе «Запросы» личного кабинета.