Документація API - KimiCode

Базова URL-адреса та аутентифікація

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

Кожен акаунт має один активний ключ одночасно; генерація нового ключа замінює старий. Запити автентифікуються через заголовок Authorization, що забезпечує безпечний доступ до вашого попередньо оплаченого кредиту.

Перший запит

Надішліть своє перше повідомлення, використовуючи стандартний ендпоінт chat completions із простим POST-запитом. Це підтверджує, що інтеграція працює, перш ніж ви занурюватиметеся в розширені функції або потокові дані. У відповіді повертається текстовий вивід від uncensored-моделі.

• Замініть YOUR_API_KEY на свій ключ з панелі керування.
• Встановіть модель на 'uncensored' для нашої конкретної моделі з відкритими вагами.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Інтеграція SDK Python

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

• Встановіть пакет openai через pip.
• Налаштуйте базовий URL так, щоб він вказував на наш сервіс.

Copyfrom openai import OpenAI

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

Інтеграція Node SDK

Інтегруйте наш API у ваші JavaScript або TypeScript додатки за допомогою Node SDK. Це забезпечує послідовну поведінку у середовищах фронтенду та бекенду. Ви можете передавати повідомлення та отримувати відповіді так само, як і зі будь-якою стандартною OpenAI-сумісною службою.

Copyimport OpenAI from "openai";

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

Потокова передача та використання токенів

Увімкніть потокове передавання для отримання генерації токенів у реальному часі через Server-Sent Events (SSE). Це зменшує сприйняту затримку для користувачів і дозволяє миттєво відображати часткові результати. Дані про використання токенів, включаючи кількість вхідних та вихідних токенів, вбудовані в останній фрагмент потоку.

Цей метод ідеальний для чат-інтерфейсів, де важлива миттєва зворотний зв'язок. Ви можете парсити потік, щоб поступово оновлювати інтерфейс користувача, не чекаючи на всю відповідь.

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)

Ліміти, помилки та контекст

Керуйте використанням, розуміючи ліміти швидкості та поширені коди помилок. API підтримує вікно контексту розміром 100,000 токенів, що дозволяє зберігати глибоку історію розмов. Ви обмежені 300 запитами на хвилину та 8 одночасними запитами на ключ.

• 401 вказує на недійсний або відсутній API-ключ.
• 402 сигналізує про вичерпання вашого передоплаченого кредиту.
• 429 означає, що ви перевищили ліміт швидкості.

Помилки не списуються з вашого кредиту, тому ви можете повторити невдалі запити без штрафу.