minimaxm3.ru › API

API MiniMax M3

Обе модели семейства доступны через платформу platform.minimax.io. Запросы принимаются в формате Anthropic, который MiniMax рекомендует, и в формате OpenAI; оплата — с баланса, в долларах за токены. Ниже — адреса, ключи, ставки, лимиты и ошибки, сверенные с документацией.

Куда отправлять запросы

Anthropic Messages, рекомендуемый

https://api.minimax.io/anthropic

OpenAI Chat Completions

https://api.minimax.io/v1

OpenAI Responses

POST /v1/responses

Имена моделей — MiniMax-M3.1-Flash и MiniMax-M3. Anthropic-совместимый интерфейс принимает только их, более старые модели вызываются через собственный API MiniMax.

Для готовых SDK достаточно сменить адрес и ключ: переменные ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY или OPENAI_BASE_URL и OPENAI_API_KEY. Количество входных токенов заранее считает эндпоинт /anthropic/v1/messages/count_tokens.

Кто ещё вызывает M2.5 или M2.7 по оплате за токены, должен до 18 ноября 2026 года сменить в коде имя модели: после этой даты старые имена работать перестанут.

Два вида ключей

Обычный ключ создаётся в разделе API Keys личного кабинета и списывает деньги с баланса; им вызываются все модели MiniMax. Ключ подписки лежит в разделе M Plan, начинает работать после оплаты тарифа или покупки кредитов и расходует квоту.

Ключи не взаимозаменяемы. Если у подписчика деньги уходят с баланса, значит, в инструменте стоит обычный ключ вместо ключа подписки. Неверный ключ даёт ошибку 2049, ключ не того типа на эндпоинтах подписки — 2057.

MiniMax советует держать ключ в переменной окружения, а не в коде, и добавлять файл .env в .gitignore. Порядок регистрации и настройки окружения для macOS, Linux и Windows описан в подготовительном разделе документации.

Минимальный запрос

curl https://api.minimax.io/anthropic/v1/messages \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3.1-Flash",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "Объясни, что такое MSA"}]
  }'

Ответ приходит блоками: сначала thinking с рассуждением, затем text. В многоходовом диалоге с инструментами MiniMax требует возвращать в историю весь ответ модели целиком, вместе с блоками thinking, иначе рвётся цепочка рассуждений. В OpenAI-формате рассуждение лежит в поле reasoning_content, а в content остаётся только ответ.

Сколько стоит

Пример. Агент на M3.1 Flash прочитал 2 млн токенов и написал 300 тыс.: 2 × 0,15 + 0,3 × 0,60 = $0,48. Если 1,5 млн входных токенов пришли из кэша, выйдет 0,5 × 0,15 + 1,5 × 0,015 + 0,18 ≈ $0,28. Рассуждение считается выходными токенами и входит в лимит max_tokens.

Источник — страница тарифов MiniMax. Сравнить ставки можно по списку разработчиков, у которых тоже есть платный API.

Что принимается, а что нет

• temperature и top_p игнорируются: у обеих моделей зафиксированы 1 и 0,95.
• top_k, stop_sequences, mcp_servers и container тоже не действуют.
• max_tokens включает рассуждение: при маленьком значении ответ обрывается на stop_reason: max_tokens без текста.
• У M3 рассуждение по умолчанию выключено, включается значением thinking: adaptive.
• service_tier: priority работает только с M3.

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

Изображения — JPEG, PNG, GIF, WEBP до 10 МБ; видео — MP4, AVI, MOV, MKV до 50 МБ; весь запрос — до 64 МБ. Видео крупнее загружается через Files API (до 512 МБ) и передаётся ссылкой mm_file://. Картинка в обычном качестве обходится примерно от 1 до 3 тыс. токенов, в высоком — до 15 тыс. и больше.

Лимиты

запросов в минуту и 10 млн токенов в минуту (вход и выход вместе) — для обеих моделей при оплате за токены.

Если не хватает, MiniMax предлагает написать в отдел продаж. У подписки M Plan свои ограничения, в часы пик они могут ужесточаться.

Частые коды ошибок

Где взять API-ключ MiniMax?

Зарегистрироваться на platform.minimax.io и создать ключ в разделе API Keys → Create new secret key. Ключ подписки M Plan лежит отдельно, в разделе Billing → M Plan, и с обычным не взаимозаменяем.

Есть ли у MiniMax бесплатный API?

В таблице цен для M3 и M3.1 Flash бесплатной квоты нет: запросы по обычному ключу оплачиваются с баланса. Бесплатно модель можно попробовать в MiniMax Code или запустить открытые веса на своём сервере.

Сколько стоит MiniMax M3 через API?

$0,30 за 1 млн входных и $1,20 за 1 млн выходных токенов, если во входе запроса до 512 тыс. токенов, и вдвое дороже для более длинных. M3.1 Flash стоит $0,15 и $0,60 при любой длине.

Работает ли API MiniMax с Claude Code и Cursor?

Да. MiniMax публикует инструкции для Claude Code, Codex, Cursor, OpenCode и других инструментов: в них подставляется адрес https://api.minimax.io/anthropic и ключ, для подписчиков M Plan — ключ подписки.