Краткое руководство по Kimi api

Предварительные требования: Установка SDK

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

Для Python установите библиотеку через pip. Для Node.js используйте npm или yarn. Эти инструменты управляют HTTP-клиентом и парсингом JSON за вас.

Аутентификация: Установка ключа kimi

Obtain your key from the dashboard and pass it as the Authorization header. Используйте базовый URL https://api.apikimi.cc/v1 для всех запросов.

Сохраните ключ в безопасных переменных окружения или файлах конфигурации. Формат заголовка Bearer YOUR_API_KEY.

Отправка первого запроса

Отправьте POST-запрос на /v1/chat/completions с вашим идентификатором модели uncensored. Ответ напрямую возвращает сгенерированный текст.

Убедитесь, что вы устанавливаете model field правильно. API возвращает сырой вывод без отказов по контенту для законных тем.

Потоковые ответы

Включите потоковую передачу, установив stream: true в теле запроса. Это возвращает фрагменты в виде событий серверных событий (SSE).

Разберите поток SSE, чтобы отображать токены в реальном времени. Последний чанк содержит статистику использования токенов для биллинга.

Настройка Function Calling

Определите инструменты в tools массив в вашем запросе. Модель возвращает вызовы инструментов вместо прямого текста, когда это уместно.

Обработайте вызовы инструментов в логике вашего приложения и отправьте результаты обратно в API для дальнейшей обработки. Поддержка для tool_choice позволяет строгое обеспечение.

Обработка ошибок и лимиты

Обработка стандартных HTTP-ошибок: 401 для недействительных ключей, 402 для недостаточного баланса и 429 для ограничений частоты запросов. Контекстное окно поддерживает до 100,000 токенов в общей сложности.

Макс. вывод составляет 16 000 токенов на запрос. Ошибки не расходуют кредит. Настройте логику повторных попыток в зависимости от кода ошибки.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikimi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikimi.cc/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);

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

Copystream = 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)