MiniMax M3.1 Flash

Указывайте точный ID модели MiniMax-M3.1-Flash. На странице модели доступны Playground и актуальные цены. Спецификация OpenAPI определяет вложенные поля запросов и ответов.

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

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

В этом примере задан лимит вывода; это не значение модели по умолчанию. Храните ключи на своём сервере. Playground использует аккаунт, в который вы вошли, и не требует вставлять API-ключ.

Форматы и аутентификация

Передавайте Content-Type: application/json и Authorization: Bearer $SEEDROUTER_API_KEY. Messages также принимает x-api-key; клиенты SDK могут включать anthropic-version: 2023-06-01. Эти форматы сохраняют собственные тела запросов и структуры ответов.

Параметры

Все поля, кроме обязательных, указанных выше, необязательны. Отсутствие поля отличается от явного null: поле принимает null только тогда, когда это объявлено в OpenAPI. Неподдерживаемые поля верхнего уровня отбрасываются; недопустимые значения поддерживаемых полей приводят к ошибке.

Chat Completions

Messages

Responses

В Playground значение model фиксировано, а все остальные поля доступны для настройки: 12 элементов для Chat, 11 для Messages и 12 для Responses. Вложенные объекты и полная история диалога вводятся в поля JSON. Недопустимые значения поддерживаемых полей блокируют отправку в браузере.

Рассуждение и ограничения

Документированное контекстное окно составляет 1 000 000 токенов. Лимит вывода — 524 288 токенов, включая рассуждение. MiniMax рекомендует выделять 131 072 токена вывода для сложных задач, но не устанавливает это значение по умолчанию.

Режим обдумывания всегда включён. Значения disabled, none и minimal не поддерживаются в настройках обдумывания этой модели. Небольшой бюджет вывода может закончиться до появления текста ответа. Этот контракт API не поддерживает service_tier, аудиоввод и структурированный вывод JSON.

Общий размер тела запроса не должен превышать 64 MB. Сервис модели проверяет точное использование контекста и содержимое удалённых медиафайлов.

Изображения и видео

Chat использует блоки содержимого image_url: {"url":"..."} и video_url: {"url":"..."}. Messages использует блоки изображений/видео с объектом source: {"type":"url","url":"..."} или {"type":"base64","media_type":"...","data":"..."}. Responses использует input_image или input_video, где значение URL может быть строкой или поддерживаемым объектом параметров.

detail принимает low, default, high; значение по умолчанию — default. Для видео диапазон fps — от 0.2 до 5, по умолчанию 1. Необязательное поле max_long_side_pixel, если оно предусмотрено во вложенной схеме, должно быть положительным целым числом.

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

Замените URL из примера адресом собственного доступного файла. Встроенный ввод использует соответствующий MIME-тип base64; для MOV это video/mov. Существующие ссылки на видео mm_file:// передаются без изменений, но этот сервис не предоставляет API загрузки Files. Ссылка должна быть доступна аккаунту, обрабатывающему запрос.

Инструменты и история диалога

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

При продолжении диалога Chat сохраняйте полное сообщение assistant, включая reasoning_content и tool_calls; сообщения инструментов требуют tool_call_id. В Messages сохраняйте блоки обдумывания, подписи и блоки tool_use и tool_result. В Responses добавляйте все возвращённые элементы вывода перед следующим вводом пользователя.

Не сводите эту историю к одному тексту ответов. Произвольные схемы параметров функций и возвращаемые поля рассуждения сохраняются. Официальный справочник Chat не определяет параметр tool_choice для этой модели.

Потоковый вывод и поля ответа

Установите stream: true, чтобы получать события, отправляемые сервером. Chat передаёт choices[].delta и завершает поток значением [DONE]; укажите stream_options: {"include_usage":true}, чтобы получить данные об использовании. Messages передаёт именованные события, например message_start, обновления блоков содержимого и message_stop. Responses передаёт события, например response.output_text.delta и response.completed.

Без потокового вывода Chat возвращает choices[].message, finish_reason и usage. Messages возвращает блоки содержимого, stop_reason и данные об использовании. Responses возвращает элементы output, статус и данные об использовании. Сохраняйте полный ответ, если приложению нужны не только отображаемые ответы.

Использование и актуальные цены

В таблице актуальных цен показаны оба диапазона входа. При суммарном входе до 512 000 токенов включительно применяется первый диапазон, свыше 512 000 — второй. Выбранный диапазон определяет стоимость всего запроса, включая вывод и кэш.

Токены чтения и записи кэша не оплачиваются повторно как обычный вход. Автоматическое кэширование проверяет подходящие повторяющиеся префиксы длиной не менее 512 токенов; попадание в кэш не гарантируется. Явный маркер кэша не нужен.

Ответы содержат количество токенов, а не денежную стоимость. Окончательные начисления отображаются в истории использования аккаунта. Неудачные запросы не оплачиваются.

Ошибки

При ошибке проверьте недопустимое поле и публичный справочник ошибок. Один и тот же ID модели поддерживает три текстовых эндпоинта выше; он не предназначен для эндпоинтов эмбеддингов или Gemini.

Официальные источники

• Вызов моделей MiniMax
• Справочник Chat Completions
• Справочник Messages
• Справочник Responses
• Продолжение после вызова функции
• Автоматическое кэширование промптов