Быстрый старт для пользователей Kimicode

Предварительные требования

Перед написанием кода создайте аккаунт на сайте kimicode.cc через Google или email. Вы сразу получите один API-ключ. Не требуется подтверждение по телефону и привязка кредитной карты. Ваш аккаунт стартует с $0.50 пробного баланса сроком на семь дней. Если вам нужна большая пропускная способность, пополните баланс через криптовалюту (USDT в сети TRC20 или USDC в сети Base) от $10. Баланс не сгорает, а ошибки и отклонения не расходуют токены.

Убедитесь, что в вашей среде разработки установлены Node.js (v18+) или Python 3.8+. Этот API строго следует спецификации клиента openai, что позволяет подключить наш эндпоинт без изменения логики библиотеки. Мы предоставляем одну модель без цензуры с идентификатором uncensored.

Установка SDK

Установите официальный SDK OpenAI для выбранного языка. Это обеспечит совместимость с функциями потоковой передачи, вызова функций и JSON-режима.

Для Python используйте pip для установки стандартной библиотеки:

• pip install openai

Для Node.js установите пакет npm:

• npm install openai

Эти библиотеки автоматически обрабатывают HTTP-форматирование. Вам не нужен клиент, специфичный для поставщика. API kimicode принимает стандартные параметры, такие как temperature, top_p и max_tokens.

Инициализация клиента

Настройте объект клиента с базовым URL kimicode и вашим API-ключом. Базовый URL — https://api.kimicode.cc/v1. Установите значение api_key равным значению, полученному при регистрации. Эта конфигурация заменяет стандартный эндпоинт api.openai.com.

• Базовый URL: https://api.kimicode.cc/v1
• Модель: uncensored
• Аутентификация: Токен Bearer через api_key

Не смешивайте этот ключ с ключами других поставщиков. Он работает исключительно с эндпоинтом kimicode. Клиент проверит ключ при первом запросе. Если ключ недействителен, вы сразу получите ошибку 401.

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

Отправьте стандартный запрос на завершение чата. ID модели должен быть uncensored. Вы можете изменить значение max_tokens до 32 000. Если параметр не указан, по умолчанию установлено 2 048. Контекстное окно составляет 100 000 токенов суммарно для промпта и завершения.

• Входные данные: Текстовые сообщения в массиве messages.
• Выходные данные: Текстовый ответ в поле choices[0].message.content.

Этот эндпоинт поддерживает JSON-режим через response_format: {"type": "json_object"}. Он не поддерживает эмбеддинги, изображения или аудио. Сосредоточьтесь на генерации качественного текста без отказов по контенту для законных тем для взрослых.

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

Включите потоковую передачу, установив stream: true. API возвращает события SSE. Каждый чанк содержит частичный текст. Статистика использования токенов включается в последний чанк потока. Это позволяет отображать вывод в реальном времени без ожидания полного ответа.

• Флаг потока: Установите значение true в теле запроса.
• Тип события: chat.completion.chunk
• Данные: Содержит delta.content для текстовых частей.

Потоковая передача не меняет тарификацию. Вы платите за общее количество обработанных токенов. Ошибки во время потоковой передачи обрабатываются корректно. Если соединение прервётся, вы можете перезапустить запрос. Модель без цензуры сохраняет связность даже при длинных потоках в пределах лимита 100 000.

Ограничения, ошибки и контекст

Мониторьте свои лимиты: 300 запросов в минуту на ключ, 8 параллельных запросов и тело запроса до 8 МБ. Если вы превысите лимит запросов, вы получите ошибку 429. Если ваш предоплаченный баланс исчерпан, вы получите ошибку 402; пополните баланс через криптовалюту, чтобы продолжить. Ошибка 401 указывает на некорректный или отсутствующий API-ключ. Обратите внимание, что неудачные запросы и отклонения не расходуют токены. Жёсткий лимит контента блокирует контент сексуального характера с участием несовершеннолетних. Весь остальной контент для взрослых разрешён.

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

Определите инструменты в параметре tools. Модель возвращает вызовы функций в ответе. Используйте tool_choice для принудительного применения определённого поведения. Эта функция работает идентично стандарту OpenAI. Разберите вызовы функций в своём коде и выполните их. Отправьте результаты в последующих сообщениях. API kimicode эффективно обрабатывает определения инструментов. Убедитесь, что ваша JSON-схема валидна. Вызов функций не требует дополнительных кредитов сверх использования токенов. Это идеально подходит для создания агентов или рабочих процессов извлечения структурированных данных.

cURL

Copycurl https://api.kimicode.cc/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

Copyfrom openai import OpenAI

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