kimiapikey.comРуководство
Базовый URL Moonshot API: укажите другой адрес
Базовый URL Moonshot API — это просто одна строка в вашем клиенте в стиле OpenAI, и её изменение позволяет направить тот же код к другому провайдеру. На этой странице показано, где находится эта строка в Python, Node, curl и популярных инструментах, а также как направить её на альтернативный эндпоинт.
Обновлено


Ключевые моменты
- Базовый URL — это единственная настройка; тело запроса остается в формате чата OpenAI.
- При смене провайдера измените три вещи: базовый URL, API-ключ, идентификатор модели.
- Наш эндпоинт — https://api.kimiapikey.com/v1, а идентификатор модели — uncensored.
- Это независимая размещенная модель, а не официальный сервис Moonshot, поэтому проверьте промпты заново.
Что на самом деле делает базовый URL
Клиенты, совместимые с OpenAI, формируют каждый запрос из двух частей: базового URL и пути. SDK объединяет их, поэтому вызов chat.completions.create превращается в POST к <base_url>/chat/completions. Провайдеры, следующие этому формату, включая Moonshot, публикуют свой базовый URL в документации. Ищите его там, а не копируйте из поста на форуме, так как это единственное значение, которое нельзя угадать.
Поэтому смена провайдера требует трех правок и ничего более:
- Базовый URL, который определяет, куда отправляется запрос.
- API-ключ, который выдается для каждого провайдера и работает только на серверах этого провайдера.
- Идентификатор модели, потому что каждый провайдер называет свои модели по-разному.
Сообщения, роли, потоковая передача, инструменты и JSON-режим сохраняют ту же структуру, поэтому миграция занимает мало времени. Все, что зависит от специфичной для провайдера функции, такой как встроенный поиск в интернете, потребует отдельной обработки.
Также полезно хранить три значения вместе в одном блоке конфигурации или одном файле среды для каждого провайдера. Когда базовый URL, ключ и идентификатор модели находятся рядом, возврат к старому провайдеру — это изменение одной строки, и вы избегаете состояния частичной миграции, когда новый ключ сопоставлен со старым адресом.
Python: пакет openai
В Python вы устанавливаете базовый URL при создании клиента. Этот пример обращается к эндпоинту на этом сайте:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Если вы предпочитаете оставить код свободным от настроек, используйте переменные окружения. SDK считывает OPENAI_BASE_URL и OPENAI_API_KEY при вызове OpenAI() без аргументов, поэтому развертывание может переключать провайдеров без изменения кода. Имейте в виду, что это также означает, что оставшаяся переменная в вашей оболочке может переопределить значение, которое вы записали в файл.
Node и curl
Официальный пакет JavaScript использует то же имя опции, записанное в camelCase:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
Без SDK базовый URL — это просто начало адреса:
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":"Hello"}]}'
Тот же эндпоинт также принимает POST /v1/responses, а GET /v1/models перечисляет, что он предоставляет. Аутентификация — это токен Bearer в заголовке Authorization в каждом случае.
Редакторы и интерфейсы чата
Инструменты с графическим интерфейсом предоставляют базовый URL под разными метками: "API base", "Override OpenAI Base URL", "Custom endpoint" или "Provider URL". Значение, которое вы вставляете, — это та же строка, что и в коде выше, заканчивающаяся на /v1. Не вставляйте полный адрес /chat/completions, если инструмент не указывает, что нужен полный URL.
После сохранения добавьте идентификатор модели вручную, если инструмент не получает список. Некоторые редакторы проверяют ключ у фиксированного провайдера и отказываются принимать пользовательские значения; в этом случае сначала найдите настройку, включающую пользовательский или совместимый с OpenAI режим. Статья о использовании API-ключа в стиле Kimi в Cursor подробно описывает такой инструмент.
Что меняется при смене провайдера
Совпадение формата не означает совпадение поведения. Перед переносом производственного трафика проверьте эти пункты по одному:
- Стиль вывода. Иная модель пишет иначе. Запустите свои реальные промпты, а не учебный пример.
- Размер контекста. Эндпоинт здесь имеет контекстное окно на 100 000 токенов для промпта и завершения. Если ваша текущая настройка отправляет более длинные промпты, сначала обрежьте их.
- Лимиты. Полный ключ позволяет 8 параллельных запросов и 300 в минуту. При превышении любого лимита вы получаете HTTP 429 с кодом
rate_limitedилиconcurrency. - Функции. Поддерживаются потоковая передача по SSE, вызов функций и JSON-режим. Генерация изображений, аудио и видео, эмбеддинги и дообучение не поддерживаются; это API только для текста.
- Названия. Сервис использует одну модель с открытыми весами, выбранную для ответов без отказов по контенту для законного использования взрослыми. Это не официальный API Moonshot и не роутер между поставщиками.
Нейтральный способ сравнения — залогировать одни и те же десять промптов через оба эндпоинта и прочитать ответы рядом. Это занимает минуты и экономит догадки.
Ошибки базового URL и как они выглядят
Большинство сбоев после переключения происходят из-за адреса, а не ключа. Вот как проявляется каждая ошибка и как её исправить.
| Ошибка | Симптом | Исправление |
|---|---|---|
Только хост, без /v1 | 404 при каждом вызове | Добавьте /v1 в конец |
| Вставлен полный путь | 404 с удвоенным путем в ошибке | Верните адрес к /v1 |
| Конечный слэш плюс ручной путь | Двойной слэш в URL | Позвольте SDK объединить путь |
| Старый ключ, новый URL | 401 | Используйте ключ, выданный новым провайдером |
| Старый URL, новый ключ | 401 от старого провайдера | Ищите старый адрес в репозитории и оболочке |
http:// вместо https:// | Ошибка перенаправления или соединения | Используйте https везде |
Быстрый способ найти остатки — поискать старое имя хоста в вашем проекте и настройках развертывания. Ищите в файлах .env, переменных CI, файлах Docker Compose и настройках любого редактора, так как одной забытой копии достаточно, чтобы направить часть трафика на старого провайдера.
Потоковая передача и инструменты после переключения
Установите stream: true, и ответ придет в виде событий, отправляемых сервером, с отчетом об использовании токенов в конце. Вызов функций использует обычные поля tools и tool_choice, потоковая передача tool_calls и результаты отправляются обратно как сообщения с role: "tool". Если ваш код уже обрабатывает это для старого провайдера, он должен продолжать работать; подтвердите это, запустив один потоковый вызов и один вызов функции перед полным переключением. Помните, что потоковый запрос удерживает слот параллельности до конца потока.
Проверка стоимости перед переключением
Здесь тарификация за токен: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов из предоплаченного баланса, без подписки. Неудачные или отклонённые запросы не оплачиваются, а баланс не сгорает. Для тарифов другого провайдера проверьте их текущую страницу цен, так как они меняются.
Рабочий пример. Предположим, запрос имеет 2 000 входных токенов и 500 выходных токенов:
- Вход: 2 000 / 1 000 000 × $0,15 = $0,0003
- Выход: 500 / 1 000 000 × $0,50 = $0,00025
- Итого: $0,00055 за запрос, поэтому 1 000 запросов стоят $0,55
Минимальная сумма пополнения — $20, крупные суммы дают бонус: +5% от $50, +10% от $100 и +15% от $200. Принимаются только криптовалюта (USDT в сети TRC20, USDC в сети Base). Полная информация доступна на странице с ценами, а подробный разбор для работы с Kimi — в разделе Тарифы на API-ключ для Kimi.
Получите ключ и выполните первый запрос
Войдите через Google или по почте и паролю, затем откройте страницу API-ключ. Новые пользователи могут одним кликом получить $0,50 пробного баланса на одного человека, срок действия — 7 дней, карта не требуется. Для ключей пробного баланса лимит составляет 2 параллельных запроса и 60 запросов в минуту — этого достаточно для тестирования.
Вставьте ключ в приведённый выше фрагмент кода на Python, запустите его и убедитесь, что вы получили текстовый ответ. В документации перечислены все параметры, а заголовки ответа X-Request-Id и X-Balance-USD помогают при отладке и отслеживании баланса. Промпты, отправленные в сервис, не используются для обучения.
Дополнительные руководства
- API-ключ Kimi не работает: причины, решения, резервный вариант
- Использование API-ключа в стиле Kimi в Cursor: Руководство по настройке
Часто задаваемые вопросы
Является ли модель той же, что и официальная Kimi от Moonshot?
Нет, мы размещаем модель с открытыми весами, настроенную на отсутствие цензуры. Это не GPT, Claude, Gemini, Grok, DeepSeek или модель другого вендора. Это отдельная модель, работающая на наших собственных серверах.
Вы используете мои данные для обучения?
Нет. Ваши промпты и ответы не используются для обучения. Мы ценим конфиденциальность и прозрачность, поэтому ваши данные остаются вашими.
Какие лимиты запросов?
Лимит составляет 300 запросов в минуту на ключ. Максимальный размер тела запроса — 8 МБ. Эти ограничения обеспечивают стабильную работу сервиса для всех пользователей.
Какая политика контента?
Модель без цензуры в отношении взрослых, спорных и творческих тем. Однако мы блокируем контент сексуального характера с участием несовершеннолетних. Это строгое ограничение, которое действует всегда, независимо от уровня подписки.
Вопросы и ответы
Нужно ли менять код при смене базового URL?
Обычно требуется изменить только три значения: базовый URL, API-ключ и идентификатор модели. Формат сообщений, потоковая передача и вызов функций остаются прежними, если новый поставщик их поддерживает.
Должен ли базовый URL заканчиваться на /v1?
Да, для этого эндпоинта: https://api.kimiapikey.com/v1. SDK автоматически добавляет /chat/completions, поэтому не включайте его в URL.
Это официальный API от Moonshot?
Нет. Это независимая размещённая модель с открытыми весами под API, совместимым с OpenAI. Это не сервис Moonshot и не роутер между поставщиками.
Где найти идентификатор модели?
Выполните запрос GET /v1/models с вашим ключом. На этом эндпоинте идентификатор модели — uncensored.
Ваш ключ — всего в одной форме от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.