Швидкий старт з Kimi api

Передумови: Встановлення SDK

Встановіть офіційний SDK для бажаної мови для автоматичної обробки автентифікації та серіалізації. Наш API відповідає стандарту OpenAI, тому будь-яка сумісна бібліотека клієнта працює з мінімальними змінами в конфігурації.

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

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

Отримайте свій ключ з панелі керування та передайте його як Authorization header. Використовуйте базову URL-адресу https://api.apikimi.cc/v1 для всіх запитів.

Збережіть ключ безпечно у змінних середовища або файлах конфігурації. Формат заголовка Bearer YOUR_API_KEY.

Надсилання першого запиту

Надішліть POST-запит на /v1/chat/completions з вашим ідентифікатором моделі uncensored. Відповідь безпосередньо повертає згенерований текст.

Переконайтеся, що ви встановлюєте model field правильно. API повертає сирій вивід без відмови в контенті для законних тем.

Потокові відповіді

Увімкніть потокову передачу, встановивши stream: true у тілі запиту. Це повертає фрагменти у вигляді подій Server-Sent Events (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)