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

kimiapikey.comДокументация

Kimi API: первый запрос за пять минут

Получите первый ответ менее чем за пять минут, используя стандартный интерфейс, совместимый с OpenAI. Это руководство охватывает настройку, аутентификацию и базовое использование модели без цензуры.

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

Требования

Для начала вам нужен API-ключ от kimiapikey.com. Зарегистрируйтесь, указав только email и пароль; для пробного периода карта не требуется. Также вам потребуется среда выполнения поддерживаемого языка с установленным официальным или совместимым SDK. Наш API следует формату OpenAI chat-completions, поэтому существующий код для GPT-3.5/4 часто работает с минимальными изменениями. Убедитесь, что версия вашего SDK достаточно новая для поддержки параметра base_url.

Базовый URL и аутентификация

Наш API доступен по адресу https://api.kimiapikey.com/v1. Аутентификация выполняется через стандартный заголовок Authorization. Передайте свой ключ в виде токена Bearer. Это работает с любым клиентом, принимающим эндпоинты, совместимые с OpenAI. Если вы используете прокси или пользовательский клиент, убедитесь, что он корректно передает заголовок Authorization. Идентификатор модели, которую вы будете запрашивать, — uncensored.

Первый запрос

Отправьте простой запрос на завершение чата, чтобы проверить настройку. Используйте команду curl ниже, заменив YOUR_API_KEY на ваш фактический ключ. Этот запрос отправляет короткий промпт модели uncensored. Если запрос успешен, вы получите ответ в формате JSON с ответом модели. Проверьте массив choices на наличие сгенерированного текста. Если вы получили ошибку 401, ваш ключ недействителен или истёк.

Python SDK

Используйте официальную библиотеку OpenAI Python для самой простой интеграции. Установите значение base_url на наш эндпоинт и укажите свой ключ. Этот пример демонстрирует базовый вызов генерации текста. Вы можете изменить параметр model при необходимости, хотя uncensored является значением по умолчанию. Этот подход сохраняет переносимость вашего кода между различными сервисами, совместимыми с OpenAI.

Node SDK

Для проектов на JavaScript/TypeScript используйте пакет npm openai. Настройте клиент с нашим базовым URL и вашим API-ключом. Это позволяет отправлять запросы непосредственно из среды Node. Синтаксис зеркально отражает Python SDK, обеспечивая согласованность при смене языка. Не забудьте корректно обрабатывать асинхронные ответы, используя await.

Потоковая передача ответов

Для вывода в реальном времени включите потоковую передачу в вашей SDK. Это отправляет фрагменты текста по мере их генерации, снижая воспринимаемую задержку. Используйте флаг stream в запросе. SDK будет выдавать частичные ответы, позволяя обновлять пользовательский интерфейс постепенно. Это идеально подходит для интерфейсов чата или генерации длинных текстов, где важна немедленная обратная связь.

Лимиты и ошибки

Каждый ключ ограничен 300 запросами в минуту. При превышении лимита вы получите ошибку 429. Тело запроса не должно превышать 8 МБ. Контекстное окно на 100 000 токенов относится к сумме промпта и ответа модели. Распространённые ошибки: 401 (неверный ключ) и 402 (недостаточно средств). Пополните баланс через панель управления, чтобы продолжить использование API. Кредиты не сгорают, ежемесячной платы нет.

cURL

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": "Write a blunt product review of a cheap VPN."}]
  }'

Python

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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Вопросы и ответы

Поддерживает ли API вызов функций?

Да, эндпоинт поддерживает вызов инструментов/функций в стандартном формате OpenAI. Вы можете определить инструменты в запросе, и модель вернёт структурированные аргументы.

Что произойдёт, если я превышу лимит запросов?

Вы получите ошибку 429 Слишком много запросов. Подождите немного и повторите попытку или увеличьте тариф предоплаченного баланса для поддержания высокой пропускной способности.

Обучается ли модель на моих данных?

Нет. Промпты, отправленные в API, не используются для обучения. Ваши данные остаются конфиденциальными и не используются для улучшения базовой модели.

Ваш ключ — всего в одной форме

Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.

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

Технические характеристики

Все реальные лимиты и возможности API в одном месте — сверьте их до пополнения.

ПараметрЗначение
Формат APIсовместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ
ID моделиuncensored
АвторизацияAuthorization: Bearer YOUR_KEY
ЭндпоинтыPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Максимум ответадо остатка окна в 100 000 токенов; max_tokens необязателен (отдельного лимита нет)
Параметрыtemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Вызов функцийда — tools, tool_choice; ответ содержит tool_calls, в том числе в потоке; результат — сообщением role: tool
Потоковая передачада — server-sent events, последний фрагмент содержит расход токенов
Контекстное окно100 000 токенов (вход и ответ вместе)
JSON-режимresponse_format: {"type": "json_object"}
Параллельные запросыдо 8 одновременно на ключ
Лимит запросов300 запросов в минуту на ключ
Заголовки ответаX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Размер запросадо 8 МБ
Цена$0,15 за 1 млн входных токенов · $0,50 за 1 млн выходных
Оплатапредоплаченный баланс по фактическому расходу; ошибки и отказы бесплатны
Бонус+5% от $50, +10% от $100, +15% от $200
Срок действияоплаченный баланс не сгорает, без подписки
ПополнениеUSDT (TRC20) или USDC (Base), любая целая сумма от $20 до $500
Пробный баланс$0,50 на 7 дней, без карты · Пробный ключ: 2 параллельных запроса, 60 в минуту; полные лимиты (8 и 300) после первого пополнения
Ключиодин активный ключ на аккаунт; новый заменяет старый
ВходGoogle или e-mail и пароль
Контентконтент для взрослых разрешён; сексуальный контент с несовершеннолетними запрещён

Коды ошибок

Ошибки приходят в JSON с постоянным type; неудачные и отклонённые запросы не оплачиваются.

КодТипЧто значит
400bad_requestневерный JSON, пустые сообщения, неверный параметр или превышено окно контекста
401missing_key · invalid_key · key_revokedнет ключа, ключ неверный или заменён новым
402no_creditбаланс пуст — пополните, работа продолжится сразу
403content_blockedсексуальный контент с несовершеннолетними — отказ, без оплаты
404not_foundнеизвестный эндпоинт
413request_too_largeтело запроса больше 8 МБ
429rate_limited · concurrencyбольше 300/мин или 8 параллельно — подождите и повторите
503upstream_busyмодель занята — повторите через несколько секунд