Быстрый старт API

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

API использует стандартную аутентификацию OpenAI-compatible. Вы получаете API-ключ сразу после регистрации через Google или электронную почту. Используйте этот ключ в Authorization header для всех запросов. Базовый URL фиксирован на https://api.mistralabliterated.com/v1. Дополнительная конфигурация для пути конечной точки не требуется.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

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

POST /v1/chat/completions

Отправляйте сообщения модели через стандартный эндпоинт завершения чата. model ID всегда uncensored. Этот эндпоинт обрабатывает взаимодействия текст-вход, текст-выход без необходимости сложных структур полезной нагрузки. Вы можете отправить сообщения system, user и assistant в одном запросе.

Copyfrom openai import OpenAI

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

Запрос возвращает структурированный ответ JSON, содержащий вывод модели. Вы можете настроить параметры, такие как temperature и top_p, чтобы контролировать креативность. Модель не отказывает в законных взрослых или спорных темах, предоставляя сырой стиль ответа. Ошибки возвращают стандартные коды состояния HTTP для удобной отладки в вашем коде.

GET /v1/models

Запрос доступных моделей для проверки подключения и конфигурации. Этот эндпоинт возвращает список доступных моделей, подтверждая правильность вашей аутентификации и базового URL. Это полезно для тестирования интеграции перед отправкой больших запросов.

Copyimport OpenAI from "openai";

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

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

Потоковая передача & инструменты

Включите потоковую передачу, установив stream: true в вашем запросе. API отправляет чанки текста через 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)

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

Параметры & Лимиты

Окно контекста поддерживает 100,000 токенов для суммарного промпта и завершения. Максимальный объем вывода за один запрос составляет 16,000 токенов, или 2,048, если вы не укажете max_tokens. Вы можете управлять генерацией с помощью temperature, top_p, stop, и seed параметры. Также доступны штрафы за частоту и присутствие для тонкой настройки.

Лимиты позволяют 300 запросов в минуту на ключ и 8 параллельных запросов. Максимальный размер тела запроса — 8 МБ. Эти лимиты обеспечивают стабильную производительность для приложений с высокой пропускной способностью. Настройте стратегию пакетной обработки, чтобы оставаться в этих пределах.

Ошибки и цены

HTTP 401 указывает на недействительный или отсутствующий API-ключ. HTTP 402 означает, что ваши предоплаченные кредиты исчерпаны; пополните баланс криптовалютой, чтобы продолжить. HTTP 429 сигнализирует об исчерпании лимита частоты запросов; подождите или уменьшите параллельность. Ошибки не потребляют кредит, поэтому вы не платите за неудачные запросы.

Тарифы: $0.15 за миллион входных токенов и $0.50 за миллион выходных токенов. Баланс не истекает, ежемесячных платежей нет. Пополнение начинается от $20 с бонусами за крупные суммы. Возврат средств не предусмотрен, но поддержка может исправить двойное списание.