Kimi K3 API

K3 совместим с форматом OpenAI. Подойдёт любой OpenAI SDK — вы направляете base_url на эндпоинт, где есть kimi-k3, и указываете строку модели. Это вся интеграция.

Быстрый старт

Этот код вызывает K3 через EvoLink, который отдаёт kimi-k3 через OpenAI-совместимый эндпоинт. Поменяйте base_url на любой другой шлюз — остальное не изменится.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_EVOLINK_API_KEY",
    base_url="https://direct.evolink.ai/v1",   # <-- the one line you change
)

response = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "user", "content": "Explain prompt caching in two sentences."},
    ],
)

print(response.choices[0].message.content)
print(response.usage)

curl https://direct.evolink.ai/v1/chat/completions \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "messages": [
      {"role": "user", "content": "Explain prompt caching in two sentences."}
    ]
  }'

Авторизация — bearer-токен: Authorization: Bearer <key>. Держите его в переменной окружения и никогда — в коде. Путь эндпоинта — /v1/chat/completions; если вы используете OpenAI SDK, укажите корень /v1, остальное SDK допишет сам.

Ключ: два честных способа получить

Коду выше нужен API-ключ, и у вас два законных варианта. Три вещи одинаковы в любом случае — тарифы ($3.00 / $0.30 / $15.00 за 1 млн, с датой), поведение модели (блоки кэша, оплата рассуждений — модель та же) и ваш код (формат OpenAI в обоих случаях; переключиться потом — одна строка base_url). Различается всё вокруг вызова:

Когда прямой путь — правильный выбор? Если вы будете пользоваться только моделями Kimi и не хотите посредника на пути запроса, идите напрямую — код с этой страницы работает и там, с base_url от Moonshot. Для всех остальных колонка шлюза — причина, по которой примеры на этом сайте используют его по умолчанию.

Получить API-ключ EvoLink — 10 бесплатных кредитов

После регистрации вы попадёте в дашборд с онбордингом. Уже есть аккаунт? Возьмите ключ в дашборде →

Как выглядит реальный ответ

Сокращено, но в остальном ровно то, что вернулось:

{
  "id": "chatcmpl-6a593017ec44f116fb614895",
  "object": "chat.completion",
  "created": 1784229923,
  "model": "kimi-k3",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "OK",
      "reasoning_content": "The user is asking me to reply with exactly \"OK\". This is a simple request with no complications..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 90,
    "completion_tokens": 47,
    "total_tokens": 137,
    "completion_tokens_details": {"reasoning_tokens": 31},
    "prompt_tokens_details": {"cached_tokens": 90}
  }
}

Два поля заслуживают внимания, потому что у них нет аналога в OpenAI:

• message.reasoning_content — размышления K3, возвращаются вместе с ответом. Сам ответ читайте из content. Рассуждения на K3 — не режим, который включают; они включены всегда.
• usage.completion_tokens_details.reasoning_tokens — сколько выходных токенов ушло на размышления. Выше — 31 из 47 токенов ради ответа из двух букв. Это тарифицируется по цене выхода.

Убедитесь, что вызов действительно сработал

HTTP 200 на K3 — ещё не доказательство успеха. Проверьте четыре вещи:

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

В коде — единственная проверка, которую стоит написать:

choice = response.choices[0]
if choice.finish_reason == "length" and not choice.message.content:
    raise RuntimeError(
        f"Reasoning consumed the whole budget "
        f"({response.usage.completion_tokens_details.reasoning_tokens} reasoning tokens). "
        f"Raise max_completion_tokens."
    )

Параметры, которые важны

Полный справочник параметров и схемы ответа: документация EvoLink по API kimi-k3.

Стриминг

Server-sent events, завершаются data: [DONE]. Особенность именно K3: первые токены, которые вы получите, — это рассуждения, а не ваш ответ. Мы замерили медиану 2,8 с до первого токена — а в трёх прогонах из пяти токен с ответом так и не пришёл, потому что потолок в 128 токенов целиком съели размышления.

stream = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Count to three."}],
    stream=True,
    stream_options={"include_usage": True},   # or you get no usage at all
)

for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    if getattr(delta, "reasoning_content", None):
        pass                      # thinking — usually not what you render
    if delta.content:
        print(delta.content, end="", flush=True)

Если вы показываете reasoning_content пользователям, помните: вы показываете им черновик модели. Большинству продуктов лучше показывать спиннер во время рассуждений и стримить только content.

FAQ по API

Какой ID у модели Kimi K3?

Ровно kimi-k3 — не kimi-k3-chat, не moonshot-k3. Ответ возвращает его в поле model — на это стоит написать проверку.

Совместим ли Kimi K3 с OpenAI?

Да. K3 отдаётся через стандартный /v1/chat/completions, поэтому любой OpenAI SDK работает без изменений — вы задаёте base_url и строку модели. Два K3-специфичных дополнения — reasoning_content в сообщении и reasoning_tokens в usage.

Нужен ли аккаунт Moonshot, чтобы пользоваться API Kimi K3?

Нет. Подойдёт любой эндпоинт, где есть kimi-k3: через EvoLink один аккаунт с 10 бесплатными кредитами открывает K3 вместе с GPT, Claude, Gemini и десятками основных мировых моделей — по тем же тарифам, что у Moonshot напрямую.

Какой base_url использовать для Kimi K3?

Через EvoLink: https://direct.evolink.ai/v1. Напрямую к Moonshot: https://api.moonshot.ai/v1. Остальной код одинаков в обоих случаях.