kimiapikey.comДокументация
Kimi API: первый запрос за пять минут
Получите первый ответ менее чем за пять минут, используя стандартный интерфейс, совместимый с OpenAI. Это руководство охватывает настройку, аутентификацию и базовое использование модели без цензуры.
Требования
Для начала вам нужен 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 | совместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ |
| ID модели | uncensored |
| Авторизация | Authorization: Bearer YOUR_KEY |
| Эндпоинты | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://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; неудачные и отклонённые запросы не оплачиваются.
| Код | Тип | Что значит |
|---|---|---|
400 | bad_request | неверный JSON, пустые сообщения, неверный параметр или превышено окно контекста |
401 | missing_key · invalid_key · key_revoked | нет ключа, ключ неверный или заменён новым |
402 | no_credit | баланс пуст — пополните, работа продолжится сразу |
403 | content_blocked | сексуальный контент с несовершеннолетними — отказ, без оплаты |
404 | not_found | неизвестный эндпоинт |
413 | request_too_large | тело запроса больше 8 МБ |
429 | rate_limited · concurrency | больше 300/мин или 8 параллельно — подождите и повторите |
503 | upstream_busy | модель занята — повторите через несколько секунд |