Как подключить Kimi API: ключ, модели и лимиты

Kimi API — платный доступ к моделям Moonshot AI из ваших программ: внутреннего помощника, обработки обращений, разбора документов потоком, агента для разработки. В поиске его пишут и по-русски — «кими апи». Подключение устроено как у OpenAI: ключ, базовый адрес и имя модели. Ниже — порядок по документации платформы на 2 октября 2026 года и то, что стоит проверить до первого счёта. Расчёт под вашу нагрузку — на карточке Kimi API для компании.

API, подписка или Kimi Code: что нужно компании

Это три разных продукта с разной оплатой, и платформа сама просит их не путать.

• Kimi API (Kimi Open Platform, platform.kimi.ai) — оплата по мере использования, без подписки: свои ключи, свой баланс, учёт каждого токена. Для интеграций и автоматизации.
• Подписка Kimi — личные тарифы и Business: готовый интерфейс для людей с чатом, агентами и презентациями. Личные тарифы оплачиваются за месяц или год, Business — за год; выбор — на карточке подписки Kimi.
• Kimi Code входит в подписку. По документации платформы API Kimi Code — отдельный сервис, независимый от Open Platform.

Простое правило: нужен готовый интерфейс Kimi для сотрудников — подписка; нужна своя интеграция, сервис или внутренний помощник — API. Баланс и оплата у них раздельные, так что если нужно и то и другое, это две покупки.

Как подключить Kimi API: ключ и первый запрос

1. Зарегистрируйтесь на platform.kimi.ai и пополните баланс — работа начинается после первого пополнения.
2. В разделе API Keys создайте ключ и сохраните его в переменной окружения MOONSHOT_API_KEY. Платформа просит не вшивать ключ в код, не оставлять в репозиториях и логах, а условия использования запрещают передавать ключи третьим лицам.
3. Укажите базовый адрес и модель. Для формата OpenAI (Chat Completions и Responses) адрес — https://api.moonshot.ai/v1, для формата Anthropic Messages — https://api.moonshot.ai/anthropic.
4. Отправьте тестовый запрос или сначала проверьте промпт в Playground — без кода.

Минимальный пример на Python с официальным OpenAI SDK (нужны Python 3.8 или новее и пакет openai версии 1.0 или новее):

pip install --upgrade 'openai>=1.0'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Составь план проверки договора поставки"}],
)
print(completion.choices[0].message.content)

Если интеграция уже написана под OpenAI или Anthropic, по документации достаточно заменить ключ и base_url. Параметры моделей при этом различаются: у K3 глубина рассуждений задаётся полем reasoning_effort, а настройка thinking от моделей K2.x ему не нужна. Для Claude Code, Codex, OpenCode и Kimi Code CLI у платформы есть отдельные инструкции подключения по ключу.

Какую модель выбрать

Все три модели — K3, K2.7 Code и K2.6 — принимают текст, изображения и видео. Платформа советует начинать с kimi-k3, для кода с упором на скорость вывода брать kimi-k2.7-code-highspeed, а при жёстком бюджете — kimi-k2.6.

Сколько токенов уйдёт: как оценить расход

Kimi API считает входные и выходные токены отдельно. От чего зависит итог:

• Рассуждения оплачиваются. Ход мысли модели возвращается в поле reasoning_content и входит в расход. K3 рассуждает всегда; на простых задачах глубину можно снизить до low — меньше и задержка, и токены.
• Документы — тоже вход. Загрузка файла и извлечение текста пока бесплатны, но извлечённый текст, переданный модели, оплачивается как входные токены.
• Повторы дешевле через кеш. Платформа сама кеширует одинаковое начало запросов — системный промпт, инструкции, описания инструментов. Совпавшая часть оплачивается по сниженной ставке. Чтобы кеш срабатывал, неизменная часть должна стоять в начале и не содержать меток времени и случайных идентификаторов.
• Пакетная обработка. Batch API для kimi-k2.7-code и kimi-k2.6 стоит 60 % обычной ставки — для задач, которым не нужен ответ сразу.
• Точный подсчёт. Для английского текста токен в среднем равен 3–4 символам; для своих данных точнее посчитать методом /v1/tokenizers/estimate-token-count.

Пример для оценки: бот поддержки получает 1 000 запросов в день, в каждом 3 000 входных токенов (из них 2 000 — неизменный системный промпт и база ответов) и 600 выходных вместе с рассуждениями. За 30 дней это 90 млн входных токенов, из которых 60 млн могут попадать в кеш, и 18 млн выходных. Эти объёмы умножают на ставки выбранной модели.

Ставки Kimi API за токены

Ставки — за 1 млн токенов, без налогов, по странице цен platform.kimi.ai на 2 октября 2026 года. У K3 отдельно оплачивается запись в кеш: $3 за 1 млн токенов при хранении 5 минут и $6 — при хранении час; ступеней по длине контекста у K3 нет. Вендор вправе менять ставки, поэтому перед расчётом мы сверяем их заново.

Лимиты Kimi API: уровни аккаунта

Ограничения зависят от суммы всех пополнений за время работы аккаунта: чем она больше, тем выше уровень.

Ваучеры в сумму пополнений не засчитываются. На нулевом уровне — три запроса в минуту: для проверки хватит, для рабочей нагрузки нет. Если нужно больше, чем даёт Tier5, платформа принимает заявку на повышение через форму отдела продаж. При пиковой загрузке лимиты могут временно снижаться, а при подозрительной активности включается защитное ограничение, которое не снимается, — ещё одна причина не раздавать ключи.

Расход держат под контролем на уровне проектов: дневной и месячный бюджет, после которого запросы проекта отклоняются (срабатывает с задержкой около 10 минут), и оповещение, когда баланс опускается ниже порога.

Данные и безопасность

• Ключи по людям и проектам. В организации на платформе есть администраторы, участники и проекты. Каждый участник создаёт свой ключ внутри проекта; при удалении человека из проекта его ключи аннулируются.
• Белый список IP. После верификации организации можно разрешить запросы только с ваших внешних адресов — для этого нужен фиксированный IPv4.
• Использование данных. Условия Open Platform (редакция 30 июля 2026 года) разрешают Moonshot AI использовать контент для работы и улучшения сервиса, если иное не согласовано письменно; ограничить использование для обучения моделей можно корпоративным соглашением. На странице о режиме Zero Data Retention платформа уточняет, что данные корпоративных клиентов по умолчанию в обучение не идут, а сам режим — содержимое запросов удаляется сразу после ответа, кроме случаев, когда хранение требует закон, — подключает корпоративным клиентам по запросу. Для картинок и видео, загруженных файлами, ZDR не гарантирован, а журналы безопасности и биллинга под него не попадают.
• Где хранятся данные. По политике конфиденциальности сервис предоставляет MOONSHOT AI PTE. LTD., данные хранятся на серверах в Сингапуре. Если в запросы попадут персональные данные, это трансграничная передача — её отражают в уведомлении Роскомнадзора.

Как оформить Kimi API на компанию

Доступ оплачивается по факту использования, поэтому заранее известной цены у него нет: стоимость зависит от моделей и объёма. Порядок у нас такой:

1. Вы присылаете задачу: какие модели нужны, ожидаемый объём запросов и токенов, долю повторяющегося контекста и требования к лимитам.
2. Мы считаем нагрузку и готовим коммерческое предложение в рублях на согласованный объём использования.
3. Выставляем счёт на организацию и заключаем договор; НДС 22 % включён.
4. Учётную запись и ключи компания создаёт на platform.kimi.ai и хранит у себя, мы помогаем с подключением и безопасным хранением ключей.
5. Бухгалтерия получает закрывающие документы.

Рекомендуем в статье Kimi API — доступ по запросу

KIMI-API-REQ

Цена по запросу Запросить КП

Подробнее →

Если сотрудникам нужен готовый Kimi без интеграции, выбирайте подписку Kimi. Как юрлицу оплачивать зарубежные сервисы в целом, разобрано в статье «Как оплатить зарубежный софт из России». Рассчитать доступ под вашу нагрузку — на карточке Kimi API.

Частые вопросы