MiniMax Chat Completions

Вызывайте MiniMax M3 и M3.1 Flash через единый метод OpenAI Chat Completions с ключом BeatAPI.

• Все актуальные модели MiniMax доступны через POST /v1/chat/completions. Для переключения меняйте model.
• Потоковая передача, вызовы функций и контекстное окно на 1M токенов. У MiniMax-M3 тарифы удваиваются при промпте свыше 512 000 токенов; MiniMax-M3.1-Flash использует единый тариф при любой длине промпта.
• Совместимо с OpenAI SDK: измените базовый URL и используйте ключ BeatAPI.
• Эти же модели также доступны через OpenAI Responses и Anthropic Messages.

Открывает эндпоинт в API Explorer. Если ввести ключ BeatAPI и отправить запрос, будет выполнен реальный вызов с оплатой из вашего баланса.

Модели

Передайте один из этих ID в model. Каждый ID обозначает отдельную модель; не считайте их псевдонимами друг друга.

• Указаны базовые цены со скидкой. Не включены тарифы для длинного контекста, кэшированного ввода и записи в кэш. См. страницу цен.
• — означает, что каталог не публикует это значение.

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

Установите пакет openai на сервере и сохраните ключ в BEATAPI_API_KEY. Не включайте ключ в код браузера. Ниже приведён пример запроса, а не запись реального ответа модели.

Прочитайте ответ в choices[0].message.content, затем проверьте finish_reason и usage. Статус HTTP 200 не гарантирует, что ответ решает вашу задачу: проверяйте результат в приложении. Текстовые запросы возвращают результат напрямую, без опроса /v1/tasks.

curl --request POST \
  --url https://direct.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

Эндпоинт и аутентификация

POST https://direct.beatapi.io/v1/chat/completions

Параметры запроса

Принимаются стандартные поля OpenAI Chat Completions. Совместимость формата запроса не означает, что каждая модель поддерживает все параметры. Проверяйте параметры, от которых зависит ваше приложение.

Стоимость длинного контекста

У MiniMax-M3 повышенный тариф включается, когда промпт превышает 512 000 токенов, и применяется ко всему запросу: цена входа, кэшированного входа и выхода удваивается. Повышение происходит сразу, а не постепенно: даже превышение на один токен означает оплату всего запроса по повышенному тарифу.

Цены MiniMax-M3 в таблице моделей выше и в таблице цен — базовые тарифы для промптов ниже порога. Перед отправкой длинной истории оцените весь промпт.

У MiniMax-M3.1-Flash нет повышенного тарифа за длинный контекст: цены входа и выхода из таблицы действуют при любой длине промпта вплоть до контекстного окна на 1 000 000 токенов. Кэшированный вход стоит $0.009 за 1M токенов.

Ответ

Без потоковой передачи вызов возвращает один JSON-объект. Ниже приведён сокращённый пример.

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "MiniMax-M3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Retry with exponential backoff and jitter, and make every handler idempotent."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 16,
    "total_tokens": 35
  }
}

Поля ответа

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

Установите "stream": true. Ответ поступает событиями chat.completion.chunk и завершается строкой data: [DONE].

• Тип содержимого — text/event-stream, без потоковой передачи — application/json.
• Текст поступает в choices[0].delta.content. Модели рассуждений сначала передают рассуждения в delta.reasoning_content.
• Ошибки до вызова модели возвращаются как обычные JSON-ошибки с HTTP-статусом, а не как события потока.
• Задайте явный тайм-аут и предусмотрите безопасное повторное подключение к потоку.

data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Retry"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" with backoff"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

Устранение ошибок

Обзор HTTP-ошибок

Ошибки аутентификации, маршрутизации, ограничения частоты и неизвестной модели возвращаются до вызова модели в формате BeatAPI с полями error.code, error.message, retryable и request_id. Остальные ошибки сохраняют формат OpenAI SDK {"error": {"message", "type", "code"}}. Код находится в error.code, ID запроса — в конце message. См. ошибки.

Все коды и правила повторных запросов: ошибки.

Примечания

• MiniMax также доступна через OpenAI Responses и Anthropic Messages.
• Эта страница описывает текстовые модели MiniMax. Видеомодели MiniMax H3 используют Video API.
• В наблюдавшихся вызовах MiniMax-M3.1-Flash настройка reasoning_effort от low до high приводила к генерации токенов рассуждений. Они оплачиваются как выходные, поэтому оставляйте в max_tokens запас и для рассуждений, и для ответа.
• Чтобы передать изображение в MiniMax-M3.1-Flash, включите его как base64 data URL в часть содержимого image_url.
• Храните ключ только на доверенном сервере и записывайте ID запроса из ответа. Повторяйте запросы только при ошибках 429, 500 и 503.