MiniMax CLI

Официальный CLI mmx платформы MiniMax со скиллом для агентов: текст, изображения, видео, речь, расшифровка аудио, анализ картинок и поиск

  • 2 210 ★ репозитория
  • Последний коммит
CLIОфициальный

Расширенный доступ

Почему такой уровень

  • Команды отправляют ваши запросы, тексты, изображения и аудио на серверы MiniMax и тратят баланс тарифа
  • Ключ API или токены OAuth хранятся в файлах в `~/.mmx`
  • Команда `mmx agent setup` меняет конфигурационные файлы выбранных агентов, а в интерактивном режиме может установить их
Все причины и проверки

minimax-ai/cli

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/minimax-cli

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Команды отправляют ваши запросы, тексты, изображения и аудио на серверы MiniMax и тратят баланс тарифа
  • Ключ API или токены OAuth хранятся в файлах в `~/.mmx`
  • Команда `mmx agent setup` меняет конфигурационные файлы выбранных агентов, а в интерактивном режиме может установить их

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MiniMax CLI ставит команду `mmx`, через которую агент или человек обращается к моделям платформы MiniMax прямо из терминала. Команда `mmx text chat` ведет диалог с моделью: поддерживает потоковый вывод, системную подсказку, историю из файла и описания инструментов, `mmx image` создает изображения по описанию с выбором соотношения сторон и пакетом из нескольких картинок, `mmx video generate` запускает асинхронную генерацию ролика (модели Hailuo-2.3 и MiniMax-H3, у второй есть стартовый кадр, опорные изображения и видео) и показывает ход выполнения. `mmx speech synthesize` озвучивает текст голосами на выбор с управлением скоростью, `mmx speech transcribe` расшифровывает аудио в текст, json или субтитры srt и vtt, `mmx vision` описывает изображение, `mmx search` ищет в сети средствами MiniMax. Для агентов в репозитории есть скилл `mmx-cli` с описанием каждой команды и флагами для неинтерактивной работы: `--non-interactive`, `--quiet`, `--output json`, `--async`, `--dry-run` и `--yes`. Отдельный скилл `h3-video` описывает работу с видеомоделью MiniMax-H3. Команда `mmx agent setup` настраивает MiniMax как поставщика модели для Claude Code, Codex, Grok Build, OpenCode, Hermes, Pi и Oh my Pi, проверяет ключ и регион до записи и перед изменением файлов делает копию. Авторизация идет через OAuth с кодом устройства и PKCE или по ключу API: `mmx auth login`, `mmx auth login --api-key`. Регион (Global на `api.minimax.io` или CN на `api.minimaxi.com`) определяется автоматически, остаток лимита показывает `mmx quota`.

Для кого. Для разработчиков и авторов контента, у которых есть тариф или ключ MiniMax и которым нужны генерация текста, картинок, видео и речи прямо из терминала и агента.

Подходит, если

  • Агенту нужно сгенерировать изображение, ролик или озвучку командой в скрипте, с выводом в json для разбора
  • Нужно расшифровать запись встречи или звонка в текст или субтитры, включая режим с говорящими и отметками времени
  • Хочется быстро спросить модель MiniMax или поискать в сети средствами платформы без отдельного сервера
  • Нужно подключить MiniMax как поставщика модели сразу в нескольких агентах одной командой `mmx agent setup`
  • Задачи идут в CI или сервисе: ключ передается флагом `--api-key`, а каталог настроек задается `MMX_CONFIG_DIR`

Не подходит, если

  • Нет доступа к MiniMax: CLI обращается только к платформе MiniMax
  • Нужны модели других поставщиков: команды `mmx` вызывают только модели MiniMax
  • Аудио длиннее 500 секунд или больше 50 МБ: такие файлы для расшифровки не принимаются
  • Поиск должен выдавать больше 10 результатов за запрос: интерфейс поиска не поддерживает постраничный вывод

Пример запроса к агенту

Сгенерируй картинку кота в скафандре через mmx и сохрани ее в папку out

Ограничения

Нужны Node.js 18 или новее и доступ к MiniMax: README требует тариф Token Plan, а настройка агентов различает подписку и ключи `sk-api-...` с оплатой по факту. Предварительная модель `MiniMax-M3.1-Flash-Preview`, которую CLI берет по умолчанию, сейчас доступна по тарифу M Plan или MiniMax Code; для ключа с оплатой по факту нужно явно указать `--model MiniMax-M3`. Расшифровка принимает wav, aiff, flac, m4a, mp3, aac, opus и ogg до 50 МБ и 500 секунд; файл больше 50 МБ отклоняется локально. Для MiniMax-H3 заранее проверяются размеры: изображение до 30 МБ, опорное видео до 50 МБ, аудио до 15 МБ, весь запрос до 64 МБ.

Поиск возвращает до 10 результатов за вызов. Данные уходят на серверы MiniMax выбранного региона. В README заявлена лицензия MIT, но файла LICENSE в репозитории нет, и GitHub лицензию не определяет: права на использование и копирование не определены, уточните у автора. Репозиторий принадлежит самой MiniMax, версия в `package.json` стоит как `0.0.0-dev`, настоящая выводится из тега при выпуске.

Как отключить. Удалите пакет командой `npm uninstall -g mmx-cli` и скилл из менеджера скиллов агента. Выйдите из аккаунта командой `mmx auth logout`, настройки и токены лежат в `~/.mmx` (или в папке из `MMX_CONFIG_DIR`). Конфигурации агентов, записанные командой `mmx agent setup`, верните из созданных ею резервных копий.

Частые вопросы

Как войти в аккаунт?

Команда `mmx auth login` предлагает OAuth (с кодом устройства по RFC 8628 и PKCE, браузер откроется для ввода кода) или вставку ключа API. Для CI подходит `mmx auth login --api-key sk-xxxxx`. OAuth и ключ взаимоисключающие: вход одним способом очищает другой. Приоритет у флага `--api-key`, затем OAuth, затем ключ из настроек.

Как работает генерация видео?

Команда `mmx video generate --prompt ...` запускает задачу и по умолчанию ждет результата, с `--async` сразу возвращает идентификатор. Статус смотрит `mmx video task get --task-id`, файл скачивает `mmx video download --file-id`. Для MiniMax-H3 по умолчанию 2K, 5 секунд и 16:9 при генерации из текста.

Что делает `mmx agent setup`?

Настраивает MiniMax для Claude Code, Codex, Grok Build, OpenCode, Hermes, Pi и Oh my Pi, сохраняя посторонние настройки. По умолчанию берет `MiniMax-M3.1-Flash-Preview` для подписки и `MiniMax-M3` для ключей `sk-api-...` с оплатой по факту. Режим `--dry-run` показывает изменения без реального запроса, сам агент команда не запускает.

Какие регионы и адреса используются?

Global на `api.minimax.io` и CN на `api.minimaxi.com`. Регион определяется автоматически (для ключа проверяются оба), задается флагом `--region` или переменной `MINIMAX_REGION`. Адрес можно переопределить переменной `MINIMAX_BASE_URL`.

Можно ли использовать CLI как библиотеку?

Да. Пакет экспортирует `mmx-cli/sdk` с типами TypeScript, описание лежит в `SDK.md`. Для скриптов также есть переменные окружения: `MINIMAX_OUTPUT`, `MINIMAX_TIMEOUT` и `MINIMAX_VERBOSE` для подробного журнала запросов.

Обсуждение

Вопросов и отзывов пока нет.

Официальный

Официальный MCP-сервер MiniMax: синтез речи, клонирование и дизайн голоса, генерация изображений и видео

MCP-серверРасширенный доступ1,6 тыс.Звезды репозитория

MCP-сервер для Autodesk 3ds Max: агент читает сцену, моделирует, настраивает материалы и модификаторы

MCP-серверШирокий доступ350Звезды репозитория

Локальный синтез речи для агентов: команда и скилл озвучивают текст, клонируют голос по записи и собирают музыку из партитуры без облака и платы за символы

CLIРасширенный доступ2 тыс.Звезды репозитория

Набор скиллов для агентов, чтобы генерировать и редактировать изображения, видео и звук через сервис muapi.ai и muapi-cli

СкиллРасширенный доступ6,3 тыс.Звезды репозитория

Higgsfield CLI

higgsfield-cli

Официальный

Официальная консольная утилита Higgsfield: более 40 моделей для изображений, видео, 3D и аудио и анализ готового видео из терминала

CLIРасширенный доступ689Звезды репозитория

Скилл пишет промпты для генерации видео, картинок и музыки на 14 платформах и по желанию отправляет их в браузере

СкиллШирокий доступ266Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MiniMax CLI (эта запись)да2 210
MiniMax MCPдаAPI-ключ1 594официальный MCP-сервер MiniMax: синтез речи, клонирование голоса, генерация изображений и видео через протокол MCP
MiniMax Skillsда13 74417 скиллов от MiniMax по разработке и документам, без доступа к моделям генерации из терминала

Коротко о README

Описание на английском и китайском называет проект официальным CLI платформы и перечисляет возможности: текст, изображения, видео, речь, зрение, поиск и два региона. Затем идут установка, быстрый старт, подробные разделы по каждой группе команд с примерами, переменные окружения, настройка агентов и обновление. В репозитории лежат справочник по SDK, описание ошибок, заметки о проектировании CLI и выпуске версий, а также два скилла для агентов.

Бейдж для README

Сообщить о проблеме

Foxx AIMiniMax CLI
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.