kimiapikey.comГайд
Используйте API-ключ в стиле Kimi в Cursor: руководство по настройке
Cursor может работать с любым endpoint, совместимым с OpenAI, поэтому подключение к этому API занимает четыре поля и около двух минут. Это руководство охватывает точные значения, тест, подтверждающий работоспособность ключа, и ошибки, с которыми вы, скорее всего, столкнётесь.
Обновлено

Ключевые моменты
- Cursor требует три значения: ваш ключ, базовый URL https://api.kimiapikey.com/v1 и имя модели
uncensored. - Сначала протестируйте ключ через curl, чтобы легко отличить проблему на стороне Cursor от проблемы на стороне API.
- Редактирование в стиле агента отправляет большие промпты, поэтому следите за входными токенами: $0,15 за 1 млн входящих, $0,50 за 1 млн исходящих.
- Пробный ключ позволяет 2 параллельных запроса, что агент Cursor может превысить. Полный ключ позволяет 8.
Краткий ответ
Если вы ищете как использовать ключ API kimi в Cursor, помните: ключ от другого провайдера работает только с его эндпоинтом. Ключ с нашего сайта работает с нашим эндпоинтом, и Cursor принимает его, так как эндпоинт поддерживает формат OpenAI chat completions. Вставьте ключ, укажите в Cursor другой базовый URL и добавьте одно пользовательское имя модели.
Полная настройка по шагам:
- Создайте аккаунт и скопируйте свой ключ со страницы API-ключ.
- Откройте Cursor, перейдите в Настройки, затем Модели.
- Вставьте ключ в поле ключа API OpenAI.
- Включите переопределение базового URL и введите
https://api.kimiapikey.com/v1. - Добавьте пользовательскую модель с именем
uncensoredи выберите её в чате.
Остальная часть этой статьи объясняет каждый шаг, даёт способ протестировать соединение вне редактора и перечисляет, что обычно идёт не так.
Что представляет собой этот ключ и чем не является
Этот сайт продаёт доступ к одной модели с открытыми весами, запущенной независимым провайдером и настроенной на ответы без отказов по контенту для законного использования взрослыми. Это не официальный API Moonshot, Kimi или любого другого вендора, и это не роутер, перенаправляющий ваш запрос к модели другого поставщика. Имя сайта отражает то, что люди ищут, а не то, кто управляет сервисом. Если у вас уже есть ключ от другого вендора, продолжайте использовать его с эндпоинтом этого вендора. Два ключа не взаимозаменяемы.
Вы получаете обычный API в стиле OpenAI: POST /v1/chat/completions и GET /v1/models, аутентификацию bearer-токеном, контекстное окно на 100 000 токенов, потоковую передачу, вызов функций и JSON-режим. Только текст. Нет генерации изображений, нет эмбеддингов и нет дообучения, что важно в редакторе, потому что функции Cursor, зависящие от этих возможностей, не будут использовать этот эндпоинт. Объяснение ключа API Kimi подробнее раскрывает название и альтернативы.
Для кодинга «uncensored» имеет практическое значение. Модель не остановится посреди задачи, потому что имя переменной или тестовый набор выглядят как чувствительные данные. Инструменты безопасности для ваших систем, парсеры логов с неаккуратными строками, скрейперы, генераторы художественной литературы и наборы для тестирования модерации — это виды работ, которые вызывают отказы в других местах. Жёсткое ограничение сохраняется: никогда не будет контента сексуального характера с участием несовершеннолетних.
Пошаговая настройка в Cursor
1. Получите ключ и пробный баланс
Войдите через Google или по email и паролю. На странице API-ключа вы можете получить $0,50 пробного баланса одним кликом. Карта не нужна, срок действия — 7 дней, одна на человека. Этого хватит на несколько сотен обычных запросов к чату, так что вы пройдёте всё руководство, не заплатив ни цента.
2. Откройте настройки моделей
В Cursor откройте Настройки и найдите раздел Модели. Названия пунктов меню меняются между версиями, поэтому ищите поле для ключа API OpenAI и переключатель или поле для переопределения базового URL OpenAI. Это два важных параметра.
3. Заполните три значения
| Поле Cursor | Значение |
|---|---|
| Ключ API OpenAI | Ваш ключ из дашборда |
| Переопределить базовый URL OpenAI | https://api.kimiapikey.com/v1 |
| Пользовательское имя модели | uncensored |
Введите базовый URL точно так, как показано. Он заканчивается на /v1, без завершающего слэша и без /chat/completions, потому что клиент добавляет путь сам. Вставленный URL с полным путём вернёт ошибку 404, а сообщение об ошибке редко объясняет причину.
4. Выберите модель и отправьте сообщение
Откройте панель чата, выберите uncensored из списка моделей и задайте небольшой вопрос, например «напиши функцию для парсинга ISO-дат». Если ответ приходит потоком, вы всё настроили правильно. Если Cursor показывает ошибку, не меняйте настройки наугад. Перейдите к следующему разделу и протестируйте эндпоинт напрямую.
5. Знайте побочный эффект переопределения
Переопределение базового URL обычно применяется ко всем моделям в стиле OpenAI, которые вы используете в Cursor, а не только к пользовательской. Если позже вы переключитесь на стандартную модель OpenAI, сначала отключите переопределение, иначе ваш запрос уйдёт на этот эндпоинт с именем модели, которое он не обслуживает.
Протестируйте ключ, прежде чем винить редактор
Две минуты в терминале экономят час догадок. Этот запрос делает то же, что Cursor: он отправляет запрос chat completion с токеном Bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Тело JSON с массивом choices означает, что ключ, URL и имя модели указаны верно. Проверьте также заголовки ответа. X-Balance-USD показывает ваш оставшийся баланс, а X-Request-Id стоит сохранить, если когда-нибудь понадобится отследить запрос.
Та же проверка на Python с официальным SDK OpenAI:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Вы также можете перечислить модели через GET /v1/models. Cursor и аналогичные клиенты иногда вызывают это при нажатии кнопки проверки, поэтому работающий вызов моделей — хороший знак. Если curl работает, а Cursor нет, проблема в настройках редактора, и таблица ошибок ниже охватывает обычные случаи.
Что меняется, когда модель пишет код в вашем редакторе
Чат в боковой панели стоит дёшево. Короткий вопрос с контекстом в несколько сотен токенов стоит долю цента. Функции редактора, прикрепляющие файлы, результаты поиска и историю разговоров, стоят дороже, потому что каждый запрос содержит всё снова. У модели есть окно в 100 000 токенов, разделяемое между промптом и ответом, и Cursor с радостью заполнит его значительную часть, если вы прикрепите большую папку.
Вот реальный расчёт. Предположим, запрос содержит 40 000 входных токенов, а модель возвращает 1 500 токенов:
- Вход: 40 000 / 1 000 000 x $0,15 = $0,006
- Выход: 1 500 / 1 000 000 x $0,50 = $0,00075
- Итого: $0,00675 за запрос, значит 100 таких запросов стоят $0,675
Это значительно дешевле доллара за тяжёлый день, но затраты на ввод данных доминируют, поэтому экономия достигается за счёт прикрепления меньшего количества файлов, а не сокращения вопросов. Начинайте новый чат при смене темы, так как старый контекст оплачивается снова при каждом шаге.
Вызов функций поддерживается API, на чём и строятся функции редактора в стиле агента. Модель решает вызвать инструмент, ваш клиент выполняет его и возвращает результат как сообщение role: "tool". Насколько хорошо любая модель управляет многошаговым агентом, зависит от модели, поэтому попробуйте её на небольшой задаче, прежде чем доверить ей рефакторинг. Одна модель с открытыми весами за API означает, что вы получаете одно поведение, а не меню для выбора.
Функции Cursor, работающие на собственных моделях Cursor, такие как автодополнение по Tab, обычно не переключаются пользовательским ключом. Проверьте текущую документацию Cursor, какие функции принимают пользовательский endpoint в стиле OpenAI, так как этот список меняется между релизами.
Распространённые ошибки и способы их исправления
| Симптом | Вероятная причина | Исправление |
|---|---|---|
| 404 или «не найдено» | Базовый URL включает путь эндпоинта или не содержит /v1 | Используйте строго https://api.kimiapikey.com/v1 |
| 401 unauthorized | Дополнительный пробел или символ новой строки во вставленном ключе, либо устаревший ключ | Скопируйте ключ заново из панели управления и вставьте его снова |
| Модель не найдена | Имя модели введено иначе | Используйте uncensored, строчными буквами, ничего больше |
429 с кодом concurrency | Слишком много одновременных запросов для вашего ключа | Дождитесь завершения текущих запросов или используйте полный ключ (8 одновременных запросов) |
429 с кодом rate_limited | Превышен лимит запросов в минуту | Замедлите темп: пробные ключи позволяют 60 запросов в минуту, полные — 300 |
429 с заголовком Retry-After: 5 | Временная перегрузка | Повторите попытку через пять секунд |
| Кнопка проверки не работает, curl работает | Редактор проверяет запрос с именем модели, которое он знает | Пропустите шаг проверки и отправьте реальное сообщение в чат |
Ошибка параллельных запросов заслуживает внимания, так как она часто удивляет пользователей с пробным ключом. Пробный ключ позволяет 2 параллельных запроса, и агент, запускающий несколько операций одновременно, может превысить лимит без ваших действий. Потоковая передача также удерживает слот до завершения потока, поэтому длинный ответ занимает один слот всё время. Полный ключ позволяет 8 одновременных запросов и 300 запросов в минуту, что комфортно для одного разработчика.
Неудачные и отклонённые запросы не оплачиваются, поэтому повторная попытка после ошибки не стоит дополнительных денег. Вы можете ознакомиться с полным списком лимитов на странице документации.
Оплата после окончания пробного периода
Подписки нет. Вы пополняете предоплаченный баланс любой суммой от $20 до $500, а запросы списывают его по $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов. Баланс не сгорает, поэтому месяц без написания кода обходится в ноль. Пополнения от $50 и выше дают бонус: +5% от $50, +10% от $100 и +15% от $200. Оплата криптовалютой (USDT на TRC20, USDC на Base). На странице цен собраны актуальные цифры.
Используя запрос с 40 000 входными и 1 500 выходными токенами из предыдущего примера, пополнение на $20 покрывает примерно 2 960 таких запросов ($20 / $0,00675). Большинство запросов редактора меньше, поэтому реальное количество будет выше. Ваши промпты не используются для обучения, что важно, когда код, который вы вставляете, принадлежит клиенту.
После завершения настройки разумной первой задачей будет небольшая задача, которую можно быстро проверить: юнит-тест для существующей функции, регулярное выражение с длинным комментарием или переписывание одного зашумлённого файла. Если результаты подходят вашему рабочему процессу, пополните баланс. Если нет, вы потратили несколько центов пробного баланса, чтобы это выяснить.
Дополнительные руководства
- Тарифы на API-ключ Kimi: сколько стоит эта альтернатива
- Интеграция ключа API Kimi с SDK OpenAI и LangChain
- API-ключ Kimi: как это работает и какие есть альтернативы
Часто задаваемые вопросы
Является ли модель той же, что и официальная Kimi от Moonshot?
Нет, мы размещаем модель с открытыми весами, настроенную на отсутствие цензуры. Это не GPT, Claude, Gemini, Grok, DeepSeek или модель другого вендора. Это отдельная модель, работающая на наших собственных серверах.
Вы используете мои данные для обучения?
Нет. Ваши промпты и ответы не используются для обучения. Мы ценим конфиденциальность и прозрачность, поэтому ваши данные остаются вашими.
Какие лимиты запросов?
Лимит составляет 300 запросов в минуту на один API-ключ. Максимальный размер тела запроса — 8 МБ. Эти ограничения обеспечивают стабильную работу сервиса для всех пользователей.
Какая политика контента?
Модель без цензуры в отношении взрослых, спорных и творческих тем. Однако мы блокируем контент сексуального характера с участием несовершеннолетних. Это строгое ограничение, которое действует всегда, независимо от уровня подписки.
Вопросы и ответы
Могу ли я вставить ключ Moonshot или Kimi в Cursor с этим базовым URL?
Нет. Ключ работает только с эндпоинтом провайдера, который его выдал. Используйте ключ из вашей панели управления здесь или оставьте другой ключ с URL своего провайдера.
Какое имя модели я должен ввести в Cursor?
Введите uncensored, строчными буквами. Это единственный идентификатор модели, который обслуживает этот API, и другое имя вернёт ошибку «модель не найдена».
Работает ли это с агентным режимом Cursor?
API поддерживает вызов функций, необходимый для агентов. Насколько надёжно модель выполняет задачи, зависит от конкретного случая, поэтому протестируйте её на небольшой задаче перед крупной.
Почему я получаю ошибку 429 на пробном ключе?
Пробный ключ позволяет 2 параллельных запроса и 60 в минуту. Полный ключ — 8 параллельных и 300 в минуту. Заголовок Retry-After: 5 указывает на кратковременную перегрузку, после которой можно повторить запрос.
Используется ли мой код для обучения?
Нет. Промпты, отправленные в API, не используются для обучения.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.