Документация API: OpenAI-Compatible Endpoints

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

Получите доступ к API, установив ваш уникальный ключ и базовый URL в переменных окружения. Endpoint находится по адресу https://api.apikeykimi.com/v1. Вы должны включить заголовок Authorization: Bearer YOUR_API_KEY с каждым запросом. Этот ключ генерируется мгновенно при регистрации через Google или электронную почту. Это единственное учётное данные, необходимое для аутентификации. Не требуется настройка областей или разрешений.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Эндпоинт Chat Completions

Отправляйте сообщения модели с помощью стандартного /v1/chat/completions endpoint. endpoint. Укажите идентификатор модели как uncensored в теле запроса. API возвращает сгенерированный текст на основе истории ваших промптов. Вы можете настроить параметры, такие как temperature и top_p, чтобы контролировать креативность. Модель поддерживает вызов функций и JSON режим для структурированных выводов.

Copyfrom openai import OpenAI

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

Потоковые ответы (SSE)

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

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)

Вызов функций & JSON Mode

Определите инструменты или принудительно задайте вывод в формате JSON с помощью response_format параметр. Установите json_object чтобы получить валидные ответы в формате JSON. Вы также можете передать определения инструментов для вызова функций. Модель строго соблюдает эти ограничения. Это позволяет надежно интегрироваться с внешними сервисами. Используйте tool_choice для управления тем, как вызываются инструменты.

Лимиты токенов & ограничения

Окно контекста поддерживает до 100 000 токенов для суммы ввода и вывода. Максимальный вывод за один запрос составляет 16 000 токенов. Если вы не установите max_tokens, лимит по умолчанию составляет 2 048 токенов. Запросы ограничены размером тела в 8 МБ. Вы ограничены 300 запросами в минуту. Только 8 запросов могут выполняться одновременно на ключ.

Обработка ошибок и лимиты использования

Обрабатывайте ошибки, проверяя код состояния HTTP. 401 указывает на недействительный или истёкший API-ключ. Ошибка 402 означает, что ваши предоплаченные средства исчерпаны. Ответ 429 сигнализирует о превышении лимита частоты запросов в 300 запросов в минуту. Ошибки и отказы не расходуют токены. Проверяйте баланс на панели управления, чтобы избежать прерываний.

Node.js

Copyimport OpenAI from "openai";

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