Ошибки 402, 403 и 429

Эта страница есть и в виде Markdown для ИИ-ассистентов — errors.md.

Konductor отвечает ошибкой, когда не хватает денег, ключ остановлен или запросов слишком много. Ниже — что значит каждый код и что делать.

В формате OpenAI (/v1/chat/completions) тело ошибки — {"error": {...}}. В формате Anthropic (/v1/messages) оно — {"type": "error", "error": {...}}, а поле code внутри то же.

402: не хватает денег или лимита

Перед запросом Konductor резервирует деньги: оценка входа по цене входа плюс max_tokens по цене выхода. Если резерв не проходит, запрос не доходит до модели.

`code`	Что случилось	Что сделать
`insufficient_balance`	Доступного баланса компании не хватает на резерв	Пополни баланс или уменьши `max_tokens`
`key_limit_exceeded`	Резерв выходит за лимит этого ключа	Дождись начала нового окна (`reset_at`) или попроси поднять лимит ключа
`company_limit_exceeded`	Резерв выходит за лимит компании	Дождись начала нового окна (`reset_at`) или попроси поднять лимит компании

Пример ответа при нехватке баланса:

{
  "error": {
    "message": "Доступного баланса не хватает на резерв запроса.",
    "type": "insufficient_balance",
    "code": "insufficient_balance",
    "available_kop": "1200",
    "required_reserve_kop": "5000",
    "hint": "reduce_max_tokens"
  }
}

Суммы в этих полях — копейки, строкой. Пример ответа при исчерпанном лимите ключа:

{
  "error": {
    "message": "Резерв запроса выходит за лимит ключа.",
    "type": "key_limit_exceeded",
    "code": "key_limit_exceeded",
    "limit_scope": "key",
    "limit_kop": "100000",
    "spent_kop": "99000",
    "required_reserve_kop": "5000",
    "limit_window": "month",
    "reset_at": "2026-11-30T21:00:00.000Z"
  }
}

403: ключ или компания остановлены

Поле reason говорит, что именно остановлено:

`reason`	Что случилось	Что сделать
`key_paused`	Ключ поставлен на паузу	Попроси администратора компании снять паузу
`key_blocked`	Ключ заблокирован	Возьми другой ключ компании
`company_blocked`	Компания заблокирована	Свяжись с поддержкой

{
  "error": {
    "message": "Ключ поставлен на паузу.",
    "type": "permission_error",
    "code": "key_paused",
    "reason": "key_paused",
    "key_id": "key-example"
  }
}

Повторять такой запрос бесполезно, пока причина не снята.

429: слишком много запросов

Превышен лимит запросов в минуту для ключа или компании (limit_scope называет, чей). Заголовок Retry-After — сколько секунд ждать до конца минутного окна. Подожди и повтори запрос.

{
  "error": {
    "message": "Превышен лимит запросов в минуту.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "limit_scope": "key",
    "rpm_limit": 60
  }
}

Остальные коды

Коды 400, 401, 413, 500, 502 и 503 перечислены в справочнике API. Остаток баланса и лимит ключа покажет запрос к /v1/key, пример — в быстром старте.