MiniMax CLI (mmx)

MiniMax CLI 是 MiniMax Token Plan 的命令行工具，通过 mmx 命令提供文本、图片、视频、语音、音乐、视觉理解、网络检索等能力。

安装

npm install -g mmx-cli
mmx auth login --api-key <your-api-key>

Agent 安装方式：将以下提示词复制给 AI Agent

帮我安装 MiniMax CLI：https://github.com/MiniMax-AI/cli
我的密钥是 <your-key>

全局常用选项

• --quiet 静默模式，减少非必要输出
• --output json|text 输出格式
• --timeout 请求超时
• --dry-run 预览命令而不执行

图片理解

mmx vision describe --image <path-or-url> [--prompt <text>]

# 基础描述
mmx vision describe --image photo.jpg

# URL 图片
mmx vision describe --image https://example.com/photo.jpg

# 定制问题
mmx vision describe --image photo.jpg --prompt "这张图里有什么？"

# 提取文字
mmx vision describe --image doc.png --prompt "提取图片中的文字"

# 预上传文件（避免大文件 base64 开销）
mmx vision describe --file-id file-123456789 --prompt "这是什么？"

图片生成

mmx image generate --prompt <text> [flags]

# 基础
mmx image generate --prompt "赛博朋克城市夜景" --aspect-ratio 16:9

# 批量生成到目录
mmx image generate --prompt "极简风格logo" --n 4 --out-dir ./logos/

# 精确尺寸
mmx image generate --prompt "宽屏风景" --width 1920 --height 1080

# 可复现
mmx image generate --prompt "城堡" --seed 42

# 保存路径
mmx image generate --prompt "山水画" --out ~/Pictures/landscape.jpg

视频生成

mmx video generate --prompt <text> [flags]

# 同步等待
mmx video generate --prompt "夕阳下，一只猫坐在窗边望向远方" --download sunset.mp4

# 异步，立即返回任务ID
mmx video generate --prompt "机器人画画" --async --quiet

# 图生视频
mmx video generate --prompt "一个女人在走路" --first-frame woman.jpg

# 首尾帧插值
mmx video generate --prompt "向前走" --first-frame start.jpg --last-frame end.jpg

# 角色一致性
mmx video generate --prompt "侦探行走" --subject-image character.jpg

# 查询任务状态
mmx video task get <task-id>

# 下载已完成视频
mmx video download <task-id> --out output.mp4

音乐生成

mmx music generate --prompt <text> [flags]

歌词结构标签：[Intro] [Verse] [Pre Chorus] [Chorus] [Interlude] [Bridge] [Outro] [Post Chorus] [Transition] [Break] [Hook] [Build Up] [Inst] [Solo]

# 带歌词
mmx music generate --prompt "轻快爵士风格" --lyrics "La la la..." --out summer.mp3

# 自动生成歌词
mmx music generate --prompt "关于夏天的流行歌曲" --lyrics-optimizer --out summer_pop.mp3

# 纯音乐
mmx music generate --prompt "电影配乐，管弦乐" --instrumental --out bgm.mp3

# 详细参数
mmx music generate --prompt "温暖的早晨民谣" \
  --vocals "男声女声二重唱，和声" \
  --instruments "原声吉他，钢琴，弦乐" \
  --bpm 95 \
  --out duet.mp3

语音合成

mmx speech synthesize --text <text> [--out <path>] [flags]

查看音色列表：mmx speech voices

# 基础合成
mmx speech synthesize --text "欢迎使用 MiniMax Token Plan" --out welcome.mp3

# 指定音色
mmx speech synthesize --text "你好" --voice "温暖女声" --out hello.mp3

# 调整语速
mmx speech synthesize --text "快速播报新闻" --speed 1.5 --out news_fast.mp3

# 从文件读取
echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3

# 带字幕
mmx speech synthesize --text "Hello world" --subtitles --out with_subs.mp3

# 流式输出
mmx speech synthesize --text "Stream test" --stream | mpv --no-terminal -

文本对话

mmx text chat --message <text> [flags]

# 简单对话
mmx text chat --message "帮我生成一首关于AI的4言诗"

# 流式输出
mmx text chat --message "解释量子计算" --stream

网络搜索

mmx search query <text>

mmx search query "MiniMax 最新动态"

其他命令

默认输出路径

不指定时，生成的文件默认保存到当前目录的 minimax-output/ 文件夹。