MiniMax api: Quickstart and SDK Guide

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

Используйте предоставленный API-ключ и укажите клиенту на выделенный базовый URL. Конечная точка для генерации ответов — https://api.minimaxaiapi.com/v1/chat/completions. Вы передаете ключ в Authorization header в виде Bearer-токена. Это работает с любым стандартным SDK OpenAI, поскольку мы следуем тому же протоколу.

• Имя заголовка: Authorization
• Значение заголовка: Bearer YOUR_API_KEY
• Базовый URL: https://api.minimaxaiapi.com/v1

Сложная настройка не требуется. Просто обновите конфигурацию в существующем проекте.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Эндпоинт Chat Completions

Отправьте POST-запрос на эндпоинт chat completions, чтобы получить текстовый ответ. Идентификатор модели uncensored. Вы должны включить массив messages с историей вашего разговора. Система обрабатывает ввод и возвращает сгенерированный текст на основе вашего промпта.

Этот эндпоинт обрабатывает генерацию текста. Он не поддерживает эмбеддинги, аудио или видео. Вы можете получать ответы потоком или ждать полный ответ. Модель поддерживает контекст до 100,000 токенов суммарно.

Copyfrom openai import OpenAI

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

Потоковая передача и использование токенов

Включите потоковую передачу, установив stream: true в вашем запросе. API возвращает Server-Sent Events (SSE) для каждого сгенерированного токена. Это позволяет отображать вывод в реальном времени. Статистика использования токенов включена в последний чанк потока. Это помогает точно отслеживать расходы без разбора каждого отдельного токена.

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

Copyimport OpenAI from "openai";

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

Function Calling и режим JSON

Используйте tools параметр для включения вызова функций. Определите ваши функции в теле запроса и позвольте модели выбрать, какую из них вызвать. tool_choice параметр позволяет принудительно вызвать определенную функцию или выбрать автоматически. Для строгого вывода JSON установите response_format для {"type": "json_object"}. Это обеспечивает, что ответ является допустимым JSON.

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

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)

Параметры и ограничения модели

Настройте поведение генерации с помощью стандартных параметров, таких как temperature, top_p, и stop. Максимальное окно контекста составляет 100,000 токенов, включая промпт и ответ. Максимальный объем вывода за один запрос — 16,000 токенов. Если вы не установите max_tokens, лимит по умолчанию составляет 2 048 токенов.

Использовать seed для воспроизводимых результатов. Установите presence_penalty и frequency_penalty для контроля повторений. Эти параметры дают вам тонкий контроль над креативностью и последовательностью модели. Всегда тестируйте с вашим конкретным сценарием использования, чтобы найти правильный баланс.

Лимиты запросов и ошибки

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

Ошибки не списывают средства с вашего кредита. Вы можете повторять неудачные запросы без штрафов. Размер тела запроса ограничен 8 МБ. Тщательно управляйте параллелизмом, чтобы избежать ограничения пропускной способности. Отслеживайте использование через последний фрагмент потоковых ответов.