Различия параметров и протоколов MiniMax

Узнайте об отличиях параметров и использовании MiniMax с совместимыми протоколами.

Для MiniMax настройте параметры по этой странице. Полные структуры: Chat Completions, Responses, Messages.

Модели

Модель	Область применения
MiniMax-M3.1-Flash	Chat, Responses, Messages; рассуждение всегда включено, глубина регулируется
MiniMax-M3	Chat, Responses, Messages; рассуждение переключается, умолчания зависят от протокола

Отличия Chat Completions

Поле	Отличие
`thinking.type`	Обе по умолчанию `adaptive`; M3 выключает через `disabled`, M3.1-Flash возвращает `400` при `disabled`
`reasoning_effort`	M3.1-Flash принимает `low/medium/high/xhigh/max`, по умолчанию `max`; `none` возвращает `400`. M3 игнорирует поле
`reasoning_split`	Расширение MiniMax: `true` выносит рассуждение в `reasoning_content`, `false` помещает в теги `<think>` внутри `content`. Не переключает рассуждение; M3.1-Flash не принимает `false`
`temperature`, `top_p`	Значения игнорируются; фактически `1`, `0.95`. Переданное `top_p` всё равно должно соответствовать `(0,1]`
`presence_penalty`, `frequency_penalty`, `logit_bias`	Значения игнорируются
`max_completion_tokens`	Минимум `1`, максимум `524288`, рекомендуется `131072`; рассуждение и ответ вместе. Рекомендация не является умолчанием
`service_tier`	M3 принимает `standard/priority`, по умолчанию `standard`; M3.1-Flash поле не поддерживает
История сообщений assistant	Передавайте полные диалоги инструментов с `reasoning_content`, `content`, `tool_calls`; простой вызов может не иметь видимого рассуждения

Отличия Responses

Поле	Отличие
`reasoning.effort`	M3.1-Flash всегда рассуждает, принимает `low/medium/high/xhigh/max`, по умолчанию `max`; `none` возвращает `400`. M3 выключено по умолчанию, любое не-`none` включает без регулировки глубины
`temperature`, `top_p`	Значения игнорируются; фактически `1`, `0.95`. Переданное `top_p` всё равно должно соответствовать `(0,1]`
`max_output_tokens`	Токены рассуждения входят в бюджет; малый бюджет может дать `incomplete` без итогового message
`tool_choice`	Только `auto`
`text.format.type`	Сейчас определено только `text`
`store`	Значение запроса игнорируется; ответ фиксирован `false`
`previous_response_id`, `conversation`	Значение игнорируется; ответ фиксирован `null`. Клиент передаёт всю историю, включая reasoning и инструменты
`parallel_tool_calls`, `truncation`	Значения игнорируются; ответы фиксированы соответственно `true`, `disabled`
`service_tier`	M3 принимает `standard/priority`, по умолчанию `standard`; M3.1-Flash поле не поддерживает
Серверный поиск	Инструмент Beta; используйте `type: "web_search"` в `tools`

Отличия Messages

Поле	Отличие
`thinking.type`	M3.1-Flash всегда включено, только `adaptive`; `disabled` возвращает `400`. M3 выключено по умолчанию; `adaptive` включает, `disabled` выключает
`output_config.effort`	M3.1-Flash принимает `low/medium/high/xhigh/max`, по умолчанию `max`; `none` возвращает `400`. M3 игнорирует
`temperature`, `top_p`	Значения игнорируются; фактически `1`, `0.95`. Переданное `top_p` всё равно должно соответствовать `(0,1]`
`top_k`, `stop_sequences`, `mcp_servers`, `context_management`, `container`	Значения игнорируются
`max_tokens`	Минимум `1`, максимум `524288`, рекомендуется `131072`; токены рассуждения также учитываются
`tool_choice.type`	Только `auto`
`service_tier`	M3 принимает `standard/priority`, по умолчанию `standard`; M3.1-Flash поле не поддерживает
История блоков assistant	Сохраняйте thinking, text, tool_use и подпись `signature`; простой вызов может не иметь thinking
Серверный поиск	Инструмент Beta; `type: "web_search_20250305"`, `name: "web_search"`

Отличия кеша

Поле	Отличие
Автоматический кеш префиксов	От 512 входных токенов, без меток; порядок совпадения: инструменты, system, история
`cache_control`	Обе модели не поддерживают явные метки Anthropic
`prompt_cache_key` в Responses	Может идентифицировать маршрутизацию кеша промпта

Отличия мультимедийного ввода

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat: `image_url.url` принимает публичный URL или Base64 Data URL
Видео	`video_url`	Chat: `video_url.url` принимает публичный URL, Base64 Data URL либо нативную ссылку `mm_file://{file_id}`
Изображение	`input_image`	Responses: `image_url` — строка URL / Base64 либо объект с `url`, `detail`
Видео	`input_video`	Responses: `video_url` — строка URL / Base64 либо объект с `url`, `fps`, `detail`, `max_long_side_pixel`
Изображение	`image`	Messages: `url` при `source.type=url`; `media_type`, `data` при `source.type=base64`
Видео	`video`	Расширение Messages: `source` принимает URL, Base64 или нативное видео с настройкой выборки кадров

Поле	Отличие
`detail`	Поддерживается `low/default/high`, по умолчанию `default`; Chat в объекте медиа, Responses в объекте URL, Messages внутри `source`
`fps`	Частота кадров: диапазон `0.2～5`, по умолчанию `1`; Chat / Responses — `video_url.fps` в видеоблоке, Messages — `source.fps`
`max_long_side_pixel`	Максимальная сторона изображения/кадра; Chat в медиа, Responses в URL видео, Messages в `source`
Размер медиа	Chat / Messages: изображения до 10 MB, URL / Base64 видео 50 MB, тело 64 MB. Загрузка видео нативным Files API до 512 MB

mm_file:// происходит из API загрузки MiniMax. Эта страница не предоставляет API загрузки AGTCloud.

Примеры запросов

Замените MODEL_ID полным ID и используйте свой API Key. Примеры для глубины M3.1-Flash; M3 см. в таблице.

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Объясните в трёх пунктах, как диагностировать тайм-аут API"}],
    "thinking": {"type": "adaptive"},
    "reasoning_effort": "low",
    "max_completion_tokens": 4096
  }'