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

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

Наш API полностью совместим с SDK OpenAI. Вам нужно лишь обновить базовый URL и указать свой API-ключ. Базовый URL для этого сервиса: https://api.mistralapi.com/v1. Аутентификация осуществляется через заголовок Authorization с использованием токена Bearer. В отличие от некоторых провайдеров, нам не нужны сложные маршруты или заголовки, специфичные для вендора; просто передайте свой ключ, как обычно.

• Базовый URL: https://api.mistralapi.com/v1
• Заголовок: Authorization: Bearer YOUR_API_KEY

Ваш API-ключ генерируется сразу после регистрации. Храните его в безопасности, так как он дает доступ к вашему предоплаченному балансу. Ежемесячных абонентских платежей нет, только оплата по факту использования токенов.

Эндпоинт Chat Completions

Основа нашего API — эндпоинт POST /v1/chat/completions. Он принимает список сообщений и возвращает сгенерированный ответ. Этот эндпоинт поддерживает стандартный формат сообщений, используемый большинством клиентов LLM. Вы должны указать идентификатор модели как "uncensored". Эта модель — большая языковая модель с открытыми весами, размещенная на наших серверах, настроенная на ответы без отказов в контенте для законного использования взрослыми.

• Эндпоинт: POST /v1/chat/completions
• Идентификатор модели: uncensored

API возвращает только текстовые ответы. Он не поддерживает изображения, аудио, видео или эмбеддинги. Для большинства разработчиков этот эндпоинт заменяет стандартный чат-эндпоинт OpenAI без изменений в коде, кроме базового URL и идентификатора модели.

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

Использование официальной библиотеки OpenAI для Python — самый быстрый способ интеграции. Установите базовый URL на наш эндпоинт и укажите свой API-ключ. Приведенный ниже код демонстрирует простой запрос на генерацию текста.

• Установите библиотеку: pip install openai
• Установите base_url в https://api.mistralapi.com/v1
• Используйте model="uncensored"

Этот подход работает, потому что наш API воспроизводит структуру ответа OpenAI. Вы можете использовать существующие библиотеки для потоковой передачи, вызова функций и JSON-режима без изменений.

Интеграция через Node SDK

Для разработчиков JavaScript/TypeScript пакет npm openai работает бесшовно. Настройте клиент с нашим базовым URL и вашим API-ключом. Это позволяет использовать одну и ту же кодовую базу как для OpenAI, так и для нашей модели без цензуры.

• Установите библиотеку: npm install openai
• Настройте baseUrl на https://api.mistralapi.com/v1
• Укажите model: "uncensored"

Эта совместимость распространяется на все стандартные параметры, такие как temperature, top_p и последовательности stop. Вы можете легко переключаться между провайдерами, изменив конфигурацию клиента.

Потоковые ответы

Мы поддерживаем потоковую передачу ответов через Server-Sent Events (SSE). Это позволяет получать токены по мере их генерации, снижая воспринимаемую задержку для пользователей. Последний чанк потока содержит статистику использования токенов для биллинга.

• Установите stream: true в вашем запросе
• Читайте чанки из ответа
• Анализируйте последний чанк для получения данных об использовании

Потоковая передача идеально подходит для чат-интерфейсов и приложений реального времени. Формат ответа соответствует стандарту потоковой передачи OpenAI, поэтому ваша существующая логика потоковой передачи будет работать без изменений.

Лимиты, ошибки и контекстное окно

Наш API имеет определенные лимиты для обеспечения стабильности. Каждый API-ключ поддерживает 300 запросов в минуту и 8 параллельных запросов. Максимальный размер тела запроса составляет 8 МБ. Контекстное окно составляет 100 000 токенов в сумме (промпт + завершение). Если вы не установите max_tokens, вывод по умолчанию составляет 2 048 токенов; в противном случае максимальный вывод — 32 000 токенов.

• 401: Неверный API-ключ
• 402: Недостаточно средств
• 429: Превышен лимит запросов

Премиум-кредит не сгорает. Ошибки и отказы бесплатны. Если у вас возникнут проблемы, используйте страницу Поддержки для возврата средств или помощи с аккаунтом.

cURL

Копироватьcurl https://api.mistralapi.com/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

Копироватьfrom openai import OpenAI

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

Копироватьimport OpenAI from "openai";

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

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

Копироватьstream = 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)