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

Опубликовано 20.11.20268 мин чтенияСредний
Артемий Миллер в кепке с логотипом Kimi рядом с логотипами Kimi и Codex и надписью «ПОДКЛЮЧИ СВОЙ КЛЮЧ».
Что узнаешь
  • Где выпустить собственный ключ Kimi API Platform
  • Как подключить Kimi отдельным профилем Codex CLI
  • Как проверить работу, расход и возврат к прежней модели
Средний
5просмотров

Kimi API key получите в своём проекте на Kimi API Platform: войдите в кабинет, откройте API Keys, создайте и безопасно сохраните ключ. Подключаем его к Codex CLI отдельным профилем, не меняя прежний config.toml. Затем проверяем выбранную модель, выполненную задачу и расход проекта.

Одну и ту же задачу я дал Kimi 3.1 Pro, Codex на GPT 6.1 Sol и Opus 5.5: написать навык, который повторяет успешный результат конкурента, и самостоятельно его улучшать. У Kimi на 3-й день началась сильнейшая деградация, отклонение от стратегии, после чего я завершил эксперимент. Поэтому ответом в чате проверку не заканчиваем: открываем готовый файл сами.

API Platform или Kimi Code: какой ключ вам нужен?

Нужен ключ Kimi API Platform с оплатой по использованию. Покупать подписку Code ради этого подключения не требуется.

СервисГде создают ключБазовый адресМодельОплата
API Platform - наш маршрутAPI Keys своего проекта: https://platform.kimi.ai/console/api-keyshttps://api.moonshot.ai/v1kimi-k3.1-proБаланс организации, учёт по проекту
Kimi Code - другой сервисKimi Code Console из документации Codehttps://api.kimi.ai/coding/v1k3.1-proМесячная/годовая подписка с ограничениями скорости

Ключи этих сервисов друг друга не заменяют. Выбор подписки Kimi разбираю в отдельной статье.

Совместимость Kimi с интерфейсом OpenAI не означает, что запросы оплачивает подписка ChatGPT. Запросы нашего профиля оплачиваются в Kimi API Platform.

Разборы подключения моделей и проверки работы ИИ-агентов смотрите в канале:

Где получить свой Kimi API key и куда его сохранить?

Войдите своим аккаунтом на https://platform.kimi.ai/. В меню текущего проекта вверху консоли выберите нужный проект. Затем откройте API Keys, создайте собственный ключ и скопируйте его.

Новый проект не обязателен. Если нужен отдельный, его создаёт администратор: меню проекта → Create Project → имя и описание → подтверждение. Если платформа требует пополнить баланс, сначала пополните его.

Запомните проект: по нему потом сверите расход. Ключ принадлежит проекту, баланс общий у организации.

Не вставляйте ключ в чат, исходный код или config.toml и не показывайте на снимках экрана. Всё, что вы в чат скидываете, попадает в контекст модели и сохраняется в истории. Codex получит ключ через переменную окружения.

Если ключ раскрыли, прекратите его использовать и перевыпустите. При поиске утечки записывайте, в каких файлах и коммитах нашли секреты, сами значения не печатайте.

Как подключить Kimi к Codex и не затереть прежние настройки?

Для этих шагов нужны macOS/Linux, Bash, Codex CLI 0.134.0 или новее и стандартная папка настроек CODEX_HOME=~/.codex. Для Desktop этот профиль не используйте. Параметры провайдера взяты из инструкции Kimi, формат профиля - из документации Codex.

  1. Завершите старую сессию. Запишите её модель и провайдера с экрана запуска, чтобы потом проверить возврат. Базовый ~/.codex/config.toml оставьте без изменений.
  2. Проверьте, свободны ли имя файла ~/.codex/kimi-platform-test.config.toml и имя провайдера kimi_platform_test. Занятые не перезаписывайте. Если выбрали другое имя файла, поменяйте его и в команде запуска; имя провайдера замените в обеих записях ниже.
  3. Создайте новый файл ~/.codex/kimi-platform-test.config.toml:
toml
model = "kimi-k3.1-pro"
model_provider = "kimi_platform_test"
model_context_window = 1048576

[model_providers.kimi_platform_test]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

kimi_platform_test - локальное имя провайдера. Секция [profiles.*] не нужна: профиль хранится отдельным файлом.

base_url заканчивается на /v1. Клиент использует POST https://api.moonshot.ai/v1/responses, дописывать /responses в базовый адрес не надо. Оставьте wire_api = "responses" и model_context_window как в примере Kimi, Chat Completions сюда не подставляйте.

  1. В том же терминале Bash выполните первую команду, вставьте ключ и нажмите Enter. Символы не показываются. Затем выполните вторую:
bash
read -s KIMI_API_KEY
export KIMI_API_KEY

Переменная действует в текущей сессии терминала. Не сохраняйте ключ открытым текстом в export в настройках оболочки. Проверьте только наличие значения:

bash
test -n "$KIMI_API_KEY" && echo set || echo missing

Если получили missing, задайте переменную заново до запуска. Нужно имя KIMI_API_KEY, указанное в env_key. Переменная MOONSHOT_API_KEY из общего Quickstart здесь не подходит.

  1. В отдельной тестовой папке без рабочих секретов и чужих данных запустите новую сессию:
bash
codex --profile kimi-platform-test

Имя профиля передаётся без .config.toml. Не добавляйте разовые --model или -c, меняющие выбор.

На старте сверьте модель kimi-k3.1-pro и провайдера kimi_platform_test. Если они отличаются, задачу не отправляйте: параметры запуска и проектные настройки имеют приоритет выше профиля. Проверьте также, не перезаписывает ли конфигурацию Codex другая программа.

Адрес и протокол вы сверили по файлу. Экран запуска не показывает фактический сетевой запрос.

Теперь проверяем подключение: ответ, файл и расход

До платного задания проверьте доступ аккаунта и баланс Platform. В Project Settings задайте дневной или месячный бюджет больше 0. Выберите сумму, которую готовы потратить: учёт и блокировка запросов могут запаздывать, расходы за это время тоже оплачиваются.

Ставки смотрите на странице цен Kimi. На сумму влияют ввод, вывод и кеширование, поэтому одного числа токенов для расчёта недостаточно.

Запишите дату, версию клиента, выбранные модель и провайдера, текст задания и расход проекта до отправки. Сам ключ в эти записи не включайте.

Отправьте hello. Ответ подтверждает базовое соединение. Теперь проверьте инструменты и результат на знакомых вам несекретных файлах:

Изучите структуру этой тестовой папки и сохраните краткое описание в structure-report.md. Укажите существующие файлы, их назначение по содержимому и что осталось непонятно. Исходные файлы не меняйте.

Откройте полученный файл сами. Проверьте вызовы инструментов и финальный ответ после них. Пути должны существовать, описание - соответствовать содержимому, исходные файлы - остаться без изменений. «Готово» без файла не принимаем.

И учитывайте, чем дешевле нейросеть вы используете, тем более продвинутый кожаный редактор ей нужен, то есть вы.

Откройте проект → Project Information → Project Overview. После обновления сравните расход до и после задания по модели и API-ключу. Статистика может запаздывать примерно на 10 минут. Ноль сразу после ответа ещё не значит, что запрос был бесплатным.

Если тем же ключом параллельно выполнялись другие запросы, разница включает и их расход. Объём использования и денежный расход запишите отдельно, с учётом кеширования.

Как посчитать расход токенов и бюджет API, разбираю в отдельной статье.

Что проверяемПо чему проверяемЧего из этого не узнать
Настройки и выбор моделиПрофиль и экран запускаФактический адрес запроса
Выполнение задачиФайл, который открыли и сверили с исходникамиКачество будущих запусков
РасходОбновлённая статистика проекта и ключаЦена одной задачи при параллельных запросах

Как вернуться к прежнему провайдеру?

Завершите сессию Kimi и запустите новую прежней командой, без --profile kimi-platform-test и разовых параметров Kimi. Стандартный запуск:

bash
codex

Сравните модель и провайдера с записью до переключения. Тестовый профиль больше не применяется, базовый файл вы не редактировали. Оставшаяся KIMI_API_KEY сама по себе провайдера не выбирает. Продолжать историю Kimi через resume для проверки возврата нельзя.

Если модель или провайдер отличаются, до рабочей задачи проверьте параметры запуска, проектные настройки и программы, меняющие конфигурацию. Сбрасывать config.toml не нужно.

Кстати, я снял полный гайд про связку для первого агента Hermes Agent, обязательно посмотрите.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

В нём я подключаю Firecrawl и проверяю навык на разных моделях. Посмотрите, как подключать инструменты и проверять работу агента в Hermes.

Если после этого хотите собрать свой проект с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Не подключилось или не сделало задачу: что проверяем?

При 429 сначала прочитайте error.type: по одному статусу нельзя решить, нужно ли пополнять баланс.

СимптомЧто проверитьЧто сделать
401Есть ли KIMI_API_KEY в терминале запуска; соответствует ли Platform-ключ адресу https://api.moonshot.ai/v1?Задайте переменную в том же терминале или вернитесь к собственному Platform-ключу
403Есть ли доступ API, разрешён ли ваш IP в организации?Проверьте права и адреса в кабинете, защиту целиком не отключайте
404, Model not foundВерно ли написано kimi-k3.1-pro, есть ли доступ у аккаунта?Исправьте опечатку или проверьте права в кабинете
404 на /v1/responsesТочно ли base_url равен https://api.moonshot.ai/v1?Исправьте адрес, уберите оставшийся адрес старого локального маршрутизатора
429, engine_overloaded_errorУказана ли перегрузка в error.type?Учитывайте Retry-After, снизьте параллельность, увеличивайте паузу между попытками
429, exceeded_current_quota_errorКаковы баланс, квота и статус аккаунта?Устраните указанную причину до повтора
429, rate_limit_reached_errorКакой лимит достигнут?Снизьте нагрузку с учётом параллельности, RPM, TPM или TPD
Обрыв, получен 499/504Обновился ли расход проекта после обрыва?Сверьте расход перед следующей платной попыткой
Ответ есть, результата нетСуществует ли structure-report.md, верно ли содержание?Укажите, что не выполнено, и решите, нужна ли следующая попытка

499 связан с прерыванием соединения, отменой или промежуточным сетевым узлом. 504 означает, что сервер не ответил за 900 секунд. Обрыв без HTTP-статуса нельзя считать 504. Перед повтором проверьте расход, не рассчитывайте на бесплатную попытку.

Предупреждение об отсутствии kimi-k3.1-pro во встроенном каталоге ещё не означает отказ API. Сверьте model_context_window = 1048576 с примером Kimi.

Если настройки не применились, начните новую сессию и проверьте параметры запуска, проекта и профиля. Ответ на hello без сверки модели и провайдера эту проверку не заменяет. Если задача сделана плохо, причина может быть в качестве работы модели, а не в соединении.

Общую диагностику Codex разбираю в отдельной статье.

«Работать своей головой»: когда подключение можно принять?

Перед работой с настоящим проектом проверьте:

  • Ключ нигде не раскрыт.
  • Профиль и модель совпали с выбранными.
  • Полученный файл проверен человеком.
  • Расход сверен после обновления статистики.
  • Возврат к прежнему провайдеру подтверждён новой сессией.

Если что-то не выполнено, оставайтесь в тестовой папке. Успешное маленькое поручение не показывает, как модель справится с долгой самостоятельной работой. Чем умнее ваша нейросеть, тем меньше приходится работать своей головой, но работать приходится всегда.

Что пришлось проверять дольше: подключение Kimi или выполненную им задачу? Напишите в комментариях в канале.

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

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

DeepSeek API key: вставляешь ключ в Cline - и проверяешь

Свой ключ DeepSeek получите в официальном кабинете и вставьте в поле DeepSeek API Key в настройках Cline. Затем выберите модель и проверьте подключение на сохранённой правке файла.

9 мин

ChatGPT не работает: сначала найдите причину, потом меняйте настройки

Если ChatGPT не работает, сначала проверьте статус и точный текст ошибки. Сохраните доступные материалы до выхода из аккаунта, затем проверяйте подходящую ветку: браузер, вход, официальный доступ или лимит.

9 мин

Cursor не работает: сначала найдите причину, не удаляйте проект

Если Cursor не работает, сохраните состояние проекта вне чата и определите сломанную функцию. Дальше проверяйте её по официальной справке, меняя только подходящую настройку.

7 мин

OpenCode и Ollama: локальная модель - проверяем результат

OpenCode подключается к Ollama командой ollama launch opencode. Выберите локальную модель с контекстом 64k или больше и проверьте её на создании файла в отдельной тестовой папке.

7 мин