RU ▾
Получить API-ключ

kimiapikey.comРуководство

Базовый URL Moonshot API: укажите другой адрес

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

Обновлено

Кабель, перемещаемый между двумя разъемами на коммутационной панели, иллюстрирует изменение базового URL API
Изометрическая иллюстрация редактора кода, соединённого светящимся кабелем с сервером API

Ключевые моменты

  • Базовый 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 в документации. Ищите его там, а не копируйте из поста на форуме, так как это единственное значение, которое нельзя угадать.

Поэтому смена провайдера требует трех правок и ничего более:

  1. Базовый URL, который определяет, куда отправляется запрос.
  2. API-ключ, который выдается для каждого провайдера и работает только на серверах этого провайдера.
  3. Идентификатор модели, потому что каждый провайдер называет свои модели по-разному.

Сообщения, роли, потоковая передача, инструменты и 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 и как они выглядят

Большинство сбоев после переключения происходят из-за адреса, а не ключа. Вот как проявляется каждая ошибка и как её исправить.

ОшибкаСимптомИсправление
Только хост, без /v1404 при каждом вызовеДобавьте /v1 в конец
Вставлен полный путь404 с удвоенным путем в ошибкеВерните адрес к /v1
Конечный слэш плюс ручной путьДвойной слэш в URLПозвольте SDK объединить путь
Старый ключ, новый URL401Используйте ключ, выданный новым провайдером
Старый 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 помогают при отладке и отслеживании баланса. Промпты, отправленные в сервис, не используются для обучения.

Часто задаваемые вопросы

Является ли модель той же, что и официальная 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. Это вся настройка.

Получить API-ключЧитать документацию