API Kimi K3.1 Pro

Старт

Первый запрос

1. Зарегистрироваться на platform.kimi.ai.
2. Пополнить баланс хотя бы на $1 — без этого флагманская модель не откроется.
3. Создать ключ в консоли, в разделе API-ключей.
4. Отправить запрос через официальный SDK OpenAI с адресом https://api.moonshot.ai/v1 и моделью kimi-k3.1-pro.

from openai import OpenAI

client = OpenAI(api_key="ваш ключ", base_url="https://api.moonshot.ai/v1")
r = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Привет"}],
)
print(r.choices[0].message.content)

Есть и второй вход — совместимый с Anthropic Messages API по адресу https://api.moonshot.ai/anthropic; через него K3.1 Pro подключают к Anthropic SDK и Claude Code. Codex работает с моделью через Responses API без прокси: в config.toml указывают провайдера, модель kimi-k3.1-pro и окно 1 048 576 токенов. Проверить запрос без кода можно в песочнице Playground на сайте платформы.

Параметры

Что настраивается, а что нет

• reasoning_effort — low, high или max, по умолчанию max. Рассуждение включено всегда, параметра thinking у K3.1 Pro нет.
• max_completion_tokens — по умолчанию 131 072, можно поднять до 1 048 576.
• Зафиксированы temperature 1.0, top_p 0.95, n 1 и оба штрафа на нуле — в запрос их не передают.
• История. В многоходовом диалоге и при вызове инструментов ответ ассистента возвращают целиком, с reasoning_content и tool_calls, а не только content.
• Поток отдаёт рассуждение и ответ раздельными полями.
• Структурированный ответ — json_schema со strict: true; разбирают только content.
• Инструменты — tool_choice, включая required, и подгрузка на ходу: описание инструмента кладут в системное сообщение посреди диалога, и оно действует с этого места.

Полный список — в руководстве по K3.1 Pro и в справке по глубине рассуждения.

Мультимодальность

Картинки и видео

Изображения передают массивом объектов в поле content — в base64 или ссылкой ms://<id файла> после загрузки. Публичные адреса картинок модель не принимает. Видео загружают через Files API с purpose=video и подключают той же ссылкой. Из Codex CLI видео не отправить: это ограничение самого Codex, сама модель видео понимает.

Кэш

Миллион токенов контекста и кэш

Кэширование работает для всех обычных запросов: повторяющийся префикс записывается автоматически. Срок хранения — 5 минут по умолчанию или час, если передать prompt_cache_options.ttl, и каждое попадание его продлевает. Кэш хранится блоками, поэтому неполный последний блок не сохраняется и оплачивается как обычный вход. Часовой срок выгоден, когда между запросами проходит больше пяти минут: доплата за него окупается со второго попадания. Сколько ушло в кэш, видно в ответе — поля cached_tokens и cache_write_tokens в usage. Подробно — в справке по кэшу.

Лимиты

Тиры и ограничения скорости

Нулевой тир годится разве что для проверки: три запроса в минуту и один одновременный. Агенту нужен хотя бы Tier1, то есть $10 пополнений. Купоны в накопленную сумму не засчитываются. При пиковой нагрузке на кластер лимиты могут временно менять, а если система сочтёт активность аккаунта подозрительной, она включает ограничение, которое уже не снимается.

Миграция

Переезд с K2.6 и K2.7 Code

С 31 октября 2026 года модели K2 закрываются для новых пользователей; у тех, кто уже ими пользуется, они работают, а к концу декабря Moonshot собирается вывести из эксплуатации всю серию. Раньше отключили kimi-k2.5 и серию moonshot-v1 (31 августа 2026 года, запросы к ним возвращают 404) и первые модели K2 (25 мая 2026 года). В списке моделей заменой для всех названа kimi-k3.1-pro.

Что поменять в коде: убрать thinking и задавать глубину через reasoning_effort, возвращать сообщение ассистента целиком, не передавать temperature и top_p. Что поменяется в счёте: выход у K3.1 Pro стоит $10 за миллион токенов против $4 у K2.7 Code, вход $2 против $0,95. Без учёта кэша те же запросы обойдутся в 2–2,5 раза дороже, зато окно вырастет вчетверо.

Оговорки

Что ещё учесть

В документации K3.1 Pro прямо сказано, что веб-поиск сейчас обновляется и в рабочих сценариях его в ближайшее время лучше не использовать. Для клиентов API Moonshot предлагает режим Zero Data Retention, без хранения данных запросов. Если нужен готовый агент для кода, а не API, у компании есть Kimi Code: он входит в подписку Kimi и оплачивается из её кредитов, а не с баланса платформы.

Читайте в номере