Документація Mini cpm API

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

Почніть кожен запит з вашим API-ключем і правильним базовим URL. Ми використовуємо стандартні заголовки OpenAI для сумісності. Ваш ключ миттєво надає доступ до uncensored моделі. Базовий URL — HTTPS://api.cpmmini.com/v1. Використовуйте заголовок Authorization: Bearer . Зберігайте ключ у безпеці. Він ідентифікує ваш акаунт передоплачених кредитів. Тут немає абонентської плати. Ви платите лише за використані токени.

Перший запит

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

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

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

Налаштування Node SDK

Інтегруйте з Node.js, використовуючи пакет npm. Налаштуйте базовий URL так, щоб він вказував на наш API. Це зберігає сумісність зі стандартами OpenAI. Встановіть залежність у своєму проекті. Ініціалізуйте клієнта своїм ключем. Викличте метод chat completions. Об'єкт відповіді містить згенерований текст. Обробляйте помилки акуратно у своїй програмі. Ця конфігурація підтримує як CommonJS, так і ES модулі. Вона ідеально підходить для чат-ботів на стороні сервера.

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

Потокова передача токенів для інтерактивного досвіду в реальному часі. Увімкніть потокову передачу у параметрах запиту. API надсилає пакети по мірі їх генерації. Це зменшує сприйману затримку для користувачів. Використовуйте кінцеву точку SSE для безперервних даних. Парсуйте кожен пакет, щоб зібрати остаточне повідомлення. Ця функція працює з SDK Python та Node. Вона є суттєвою для чат-інтерфейсів. Моніторьте використання токенів у кінцевому пакеті. Ваші кредити списуються на основі загальної кількості надісланих токенів.

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

Слідкуйте за лімітами швидкості та статусом кредиту. Ви отримуєте 300 запитів на хвилину. Дозволено лише вісім одночасних запитів на ключ. Помилка 429 означає, що ви досягли ліміту. Помилка 402 вказує на недостатність кредиту. Поповніть за допомогою криптовалюти, щоб продовжити. Контекстне вікно підтримує 100 000 токенів. Це дозволяє вести довгі розмови без втрати історії. Помилки та відмови не коштують кредитів. Ваш передоплачений кредит ніколи не прострочується. Керуйте своїми ключами в панелі керування.

cURL

Copycurl https://api.cpmmini.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send test message"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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

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)