MiniMax CLI (mmx)#

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

安装#

bash

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

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

text

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

全局常用选项#

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

图片理解#

bash

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

参数说明--image <path-or-url>图片路径或 URL（本地路径自动 base64 编码）--file-id <id>预上传的文件 ID（跳过 base64 转换）--prompt <text>关于图片的问题（默认：描述图片）bash

# 基础描述
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 "这是什么？"

图片生成#

bash

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

参数说明--prompt <text>图片描述（必填）--aspect-ratio <ratio>宽高比，如 16:9、 1:1``--n <count>生成数量（默认1）--width <px>宽度（512-2048，必须是8的倍数）--height <px>高度（512-2048，必须是8的倍数）--seed <n>随机种子（可复现）--out <path>精确保存路径（单图）--out-dir <dir>保存目录--out-prefix <prefix>文件名前缀--response-format url|base64返回格式（默认url）--prompt-optimizer自动优化提示词--aigc-watermark添加AI生成水印--subject-ref <params>角色一致性参考bash

# 基础
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

视频生成#

bash

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

模型说明触发方式Hailuo-2.3 (T2V)文本生视频（默认）直接使用 --promptHailuo-2.3 (I2V)图生视频--first-frameHailuo-2.3-Fast快速图生视频--first-frame + fastHailuo-02 (SEF)首尾帧插值--first-frame + --last-frameS2V-01角色一致性--subject-image参数说明--prompt <text>视频描述（必填）--model <model>指定模型--first-frame <path-or-url>首帧图片--last-frame <path-or-url>尾帧图片（需配合 --first-frame）--subject-image <path-or-url>角色参考图--download <path>保存路径（同步等待时）--no-wait / --async异步模式，立即返回任务ID--poll-interval <seconds>轮询间隔（默认5秒）--callback-url <url>完成通知Webhookbash

# 同步等待
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

音乐生成#

bash

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

模型说明music-2.6推荐music-2.6-free免费版（无限量）music-2.5+增强版music-2.5标准版参数说明--prompt <text>音乐风格描述（最多2000字符）--lyrics <text>歌词（带结构标签）--lyrics-file <path>从文件读取歌词--lyrics-optimizer从 prompt 自动生成歌词--instrumental纯音乐模式--vocals <text>人声风格--genre <text>音乐流派--mood <text>情绪--instruments <text>乐器--tempo <text>节奏描述--bpm <n>精确 BPM--key <text>调性--structure <text>歌曲结构--out <path>保存路径（必填）--format <fmt>音频格式（默认mp3）--model <model>模型选择--output-format hex|url返回格式（默认hex）

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

bash

# 带歌词
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

语音合成#

bash

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

模型说明speech-2.8-hd高清（默认）speech-2.6标准版speech-02轻量版参数说明默认值--text <text>文本（最多10k字符）必填--text-file <path>从文件读取---voice <id>音色IDEnglish_expressive_narrator--out <path>保存路径---model <model>模型speech-2.8-hd--speed <n>语速倍数1.0--pitch <n>音调调整---volume <n>音量---format <fmt>音频格式mp3--sample-rate <hz>采样率32000--bitrate <bps>比特率128000--language <code>语言增强---subtitles包含字幕时间轴---pronunciation <from/to>自定义发音-

查看音色列表： mmx speech voices

bash

# 基础合成
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 -

文本对话#

bash

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

参数说明--message <text>消息内容--model <model>模型选择--stream流式输出bash

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

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

网络搜索#

bash

mmx search query <text>

bash

mmx search query "MiniMax 最新动态"

其他命令#

命令说明mmx auth status认证状态mmx auth refresh刷新 Tokenmmx quota show用量配额mmx config show查看配置mmx config set <key> <value>设置配置mmx update检查更新mmx打开交互面板

默认输出路径#

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