Ошибки и режимы отказа Kimi K3

Как устроена ошибка

Ошибки приходят единым объектом error с полями message, type и code:

{
  "error": {
    "message": "API key is missing or invalid",
    "type": "invalid_authentication_error",
    "code": null
  }
}

Не ветвитесь по code. Поле допускает null, и во всех ошибках, которые мы спровоцировали напрямую у Moonshot, его не было вовсе. Всегда заполненным оказывалось поле type — сопоставляйте по нему.

Через шлюз тела ошибок авторизации и «модель не найдена» ниже не совпадут байт в байт. Неверный ключ отбивает собственный слой авторизации шлюза, и до Moonshot запрос не доходит — вы получите его формулировку, а не формулировку Moonshot. Симптомы, причины и способы починки от этого не меняются. Поведенческие находки на этой странице — ловушка с пустым content, параметры без валидации — свойства самой модели и действуют везде, где отдают K3.

{
  "error": {
    "message": "Invalid Authentication",
    "type": "invalid_authentication_error"
  }
}

Ошибки по симптомам

{"error": {
  "message": "Invalid Authentication",
  "type": "invalid_authentication_error"
}}

{"error": {
  "message": "Not found the model kimi-k3-chat
              or Permission denied",
  "type": "resource_not_found_error"
}}

{"error": {
  "code": "model_not_found",
  "did_you_mean": "kimi-k3",
  "message": "Model 'kimi-k3-chat' is not
              available for this API key
              (unknown model id, or not
              enabled for your group). This
              error is permanent — do not
              retry with the same model id.
              Did you mean 'kimi-k3'? Call
              GET /v1/models to list the
              models available to this key."
}}

{"error": {
  "message": "Invalid request: messages
              must not be empty",
  "type": "invalid_request_error"
}}

{"error": {
  "message": "tool_choice 'specified' is
              incompatible with thinking
              enabled",
  "type": "invalid_request_error",
  "code": null
}}

{"error": {
  "message": "Rate limit exceeded",
  "type": "...",
  "code": null
}}

Сбои, которые не возвращают ошибку

Эту категорию стоит усвоить. K3 не валидирует ваши параметры — мы нашли два случая, когда очевидно некорректный запрос возвращает чистый HTTP 200:

Урок шире этих двух случаев: 200 от K3 не означает, что запрос понят так, как вы задумали. Если вы рассчитываете, что параметр меняет поведение, — проверьте, что поведение действительно изменилось, а не выводите это из отсутствия ошибки. Вместе с ловушкой пустого content правило простое: проверяйте сам ответ, а не код статуса.

Чек-лист перед релизом

1. model в ответе повторяет kimi-k3 — шлюз ничего молча не подменил.
2. finish_reason == "stop", а не "length".
3. content непустой.
4. usage.total_tokens ненулевой, и вы логируете reasoning_tokens.
5. Клиентский таймаут в минутах, если работаете с длинным контекстом.
6. Каждый параметр, на который вы полагаетесь, проверен по наблюдаемому поведению, а не по коду 200.

Готовая проверка для вашего кода — в руководстве по API.

Частые вопросы об ошибках Kimi K3

Что означает ошибка 401 Invalid Authentication у Kimi K3?

Ваш API-ключ отсутствует, опечатан, отозван, либо из заголовка Authorization потерялся префикс Bearer. Тело ответа — {"error": {"message": "Invalid Authentication", "type": "invalid_authentication_error"}} без поля code, поэтому сопоставляйте по type, а не по code.

Почему Kimi K3 возвращает 404 model not found?

ID модели — ровно kimi-k3. Прямой 404 от Moonshot смешивает неверное имя модели с проблемой прав доступа: оно звучит как 'Not found the model X or Permission denied'. При повторной проверке 2026-07-18 через EvoLink тело 404 содержит поле did_you_mean, указывающее на kimi-k3. Если написание верное, дело в доступе или в том, что шлюз не отдаёт K3, а не в опечатке.

Валидирует ли API Kimi K3 параметры запроса?

Ненадёжно. Два некорректных запроса возвращают HTTP 200 с обычным завершением: reasoning_effort со значением 'low' молча игнорируется, а max_completion_tokens со значением 2 000 000 — почти вдвое больше контекстного окна — молча урезается до потолка (повторно проверено 2026-07-18). Принудительный выбор конкретной функции через tool_choice падает по-настоящему: 400, tool_choice 'specified' is incompatible with thinking enabled. Код 200 не означает, что запрос понят так, как вы задумали.