Scan to join WeChat groupMiniMax 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 <seconds>请求超时--dry-run预览命令而不执行
图片理解
mmx vision describe --image <path-or-url> [--prompt <text>]
| 参数 | 说明 |
|------|------|
| --image <path-or-url> | 图片路径或 URL（本地路径自动 base64 编码） |
| --file-id <id> | 预上传的文件 ID（跳过 base64 转换） |
| --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]
| 参数 | 说明 |
|------|------|
| --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> | 角色一致性参考 |
# 基础
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]
| 模型 | 说明 | 触发方式 |
|------|------|---------|
| Hailuo-2.3 (T2V) | 文本生视频（默认） | 直接使用 --prompt |
| Hailuo-2.3 (I2V) | 图生视频 | --first-frame |
| Hailuo-2.3-Fast | 快速图生视频 | --first-frame + fast |
| Hailuo-02 (SEF) | 首尾帧插值 | --first-frame + --last-frame |
| S2V-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> | 完成通知Webhook |
# 同步等待
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]
| 模型 | 说明 | |------|------| | 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]
# 带歌词
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]
| 模型 | 说明 | |------|------| | speech-2.8-hd | 高清（默认） | | speech-2.6 | 标准版 | | speech-02 | 轻量版 |
| 参数 | 说明 | 默认值 |
|------|------|-------|
| --text <text> | 文本（最多10k字符） | 必填 |
| --text-file <path> | 从文件读取 | - |
| --voice <id> | 音色ID | English_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
# 基础合成
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]
| 参数 | 说明 |
|------|------|
| --message <text> | 消息内容 |
| --model <model> | 模型选择 |
| --stream | 流式输出 |
# 简单对话
mmx text chat --message "帮我生成一首关于AI的4言诗"
# 流式输出
mmx text chat --message "解释量子计算" --stream
网络搜索
mmx search query <text>
mmx search query "MiniMax 最新动态"
其他命令
| 命令 | 说明 |
|------|------|
| mmx auth status | 认证状态 |
| mmx auth refresh | 刷新 Token |
| mmx quota show | 用量配额 |
| mmx config show | 查看配置 |
| mmx config set <key> <value> | 设置配置 |
| mmx update | 检查更新 |
| mmx | 打开交互面板 |
默认输出路径
不指定时，生成的文件默认保存到当前目录的 minimax-output/ 文件夹。