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

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

Начните с указания базового URL для вашего клиента: https://api.kimicode.top/v1. Для каждого запроса нужен API-ключ. Создайте его, нажав Получить API-ключ на сайте. Войдите через Google или используйте email и пароль. Номер телефона не требуется. Ключ отображается сразу после создания. Храните его в безопасности; на аккаунт действует только один активный ключ. Если вы создадите новый ключ, старый перестанет работать. Передавайте ключ в заголовке Authorization в виде bearer-токена.

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

Отправьте первый промпт на эндпоинт chat completions. Используйте идентификатор модели uncensored. API принимает стандартные форматы, совместимые с OpenAI. Ввод поступает, текст возвращается. Ошибки и отказы бесплатны, поэтому вы платите только за успешное использование токенов. Протестируйте подключение простым промптом.

Копироватьcurl https://api.kimicode.top/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."}]
  }'

Если ключ недействителен, вы получите ошибку 401. Если у вас нет средств, вы получите ошибку 402. Если запросы завершаются неудачей, проверьте баланс аккаунта.

Интеграция через Python SDK

Используйте официальный Python SDK от OpenAI. Установите базовый URL на наш эндпоинт. Передайте свой API-ключ. Клиент автоматически обрабатывает формат запроса. Это работает для любого языка, поддерживающего клиентов, совместимых с OpenAI. Установите библиотеку через pip. Настройте клиент, указав базовый URL и ключ. Отправьте сообщение через эндпоинт завершения чата. Ответ содержит сгенерированный текст. Вы можете напрямую извлечь содержимое из объекта ответа.

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.top/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 SDK

SDK Node.js работает идентично. Импортируйте клиент. Настройте базовый URL и API-ключ. Вызовите метод завершения чата. Передайте идентификатор модели и массив сообщений. Структура ответа соответствует формату OpenAI. Извлеките содержимое сообщения ассистента. Этот подход работает для генерации на сервере или в edge-функциях. Дополнительная конфигурация не требуется, кроме изменения базового URL.

Копироватьimport OpenAI from "openai";

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

Обработка ошибок: проверяйте код статуса. Лимит запросов возвращает 429. Недостаточно средств возвращает 402.

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

Включите потоковую передачу, установив stream: true. API возвращает Server-Sent Events (SSE). Каждый чанк содержит частичный контент. Детали использования токенов появляются в последнем чанке. Это снижает воспринимаемую задержку для длинных выводов. Правильно обрабатывайте завершение потока. Закрывайте соединение, когда поток заканчивается или возникает ошибка. Потоковая передача работает со всеми стандартными клиентами, поддерживающими SSE.

Копировать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)

Убедитесь, что ваш клиент правильно буферизует чанки. Соедините содержимое, чтобы получить окончательный ответ.

Лимиты, ошибки и контекст

Контекстное окно составляет 100 000 токенов в сумме. Максимальный вывод — 32 000 токенов на запрос. Установите 2 048, если max_tokens не задан. Лимит запросов — 300 запросов в минуту на ключ. Лимит параллельных запросов — 8 одновременных запросов. Максимальный размер тела запроса — 8 МБ. Ошибки включают 401 для недействительных ключей, 402 для отсутствия кредита и 429 для лимитов запросов. Кредит не сгорает. Ошибки бесплатны. Нет скрытых подписок.