Mini cpm API documentation

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

Начните каждый запрос с вашего API-ключа и правильного базового URL. Мы используем стандартные заголовки OpenAI для совместимости. Ваш ключ сразу предоставляет доступ к модели без ограничений. Базовый URL — HTTPS://api.cpmmini.com/v1. Используйте заголовок Authorization: Bearer . Храните ключ в безопасности. Он идентифицирует ваш аккаунт с предоплаченными средствами. Подписок здесь нет. Вы платите только за использованные токены.

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

Отправьте первое сообщение в конечный пункт chat completions. Это подтверждает работоспособность ключа и корректность списания кредитов. uncensored-модель отвечает без типичных отказов. Используйте curl для быстрого теста. Замените YOUR_API_KEY на ваш реальный ключ из панели управления. Этот шаг проверяет подключение и задержку. Ошибки 401 указывают на недействительный ключ. Проверьте панель управления аккаунта, если запрос не сработает. В ответе возвращается сгенерированный текст.

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

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

Настройка Node SDK

Интегрируйтесь с Node.js, используя пакет npm. Настройте базовый URL так, чтобы он указывал на наш API. Это сохраняет совместимость со стандартами OpenAI. Установите зависимость в вашем проекте. Инициализируйте клиент с вашим ключом. Вызовите метод завершения чата. Объект ответа содержит сгенерированный текст. Обработайте ошибки корректно в вашем приложении. Эта настройка поддерживает как 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)