📦 MiniMax CLI (mmx) — MiniMax 命令行工具 (mmx)

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

安装 npm install -g mmx-cli mmx auth login --api-key

Agent 安装方式：将以下提示词复制给 AI Agent 帮我安装 MiniMax CLI：https://github.com/MiniMax-AI/cli 我的密钥是

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

图片理解 mmx vision describe --image [--prompt ]

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

# 基础描述 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 [flags]

参数 --prompt 图片描述（必填） --aspect-ratio 宽高比，如 16:9、1:1 --n 生成数量（默认1） --width 宽度（512-2048，必须是8的倍数） --height 高度（512-2048，必须是8的倍数） --seed 随机种子（可复现） --out 精确保存路径（单图） --out-dir

保存目录 --out-prefix 文件名前缀 --response-format url|base64 返回格式（默认url） --prompt-optimizer 自动优化提示词 --aigc-watermark 添加AI生成水印 --subject-ref 角色一致性参考

# 基础 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 [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 视频描述（必填） --model 指定模型 --first-frame 首帧图片 --last-frame 尾帧图片（需配合 --first-frame） --subject-image 角色参考图 --download 保存路径（同步等待时） --no-wait / --async 异步模式，立即返回任务ID --poll-interval 轮询间隔（默认5秒） --callback-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 # 下载已完成视频 mmx video download --out output.mp4

音乐生成 mmx music generate --prompt [flags]

模型 说明 music-2.6 推荐 music-2.6-free 免费版（无限量） music-2.5+ 增强版 music-2.5 标准版

参数 --prompt 音乐风格描述（最多2000字符） --lyrics 歌词（带结构标签） --lyrics-file 从文件读取歌词 --lyrics-optimizer 从 prompt 自动生成歌词 --instrumental 纯音乐模式 --vocals 人声风格 --genre 音乐流派 --mood 情绪 --instruments 乐器 --tempo 节奏描述 --bpm 精确 BPM --key 调性 --structure 歌曲结构 --out 保存路径（必填） --format 音频格式（默认mp3） --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 [--out ] [flags]

模型 说明 speech-2.8-hd 高清（默认） speech-2.6 标准版 speech-02 轻量版

参数 默认值 --text 文本（最多10k字符） 必填 --text-file 从文件读取 - --voice 音色ID English_expressive_narrator --out 保存路径 - --model 模型 speech-2.8-hd --speed 语速倍数 1.0 --pitch 音调调整 - --volume 音量 - --format 音频格式 mp3 --sample-rate 采样率 32000 --bitrate 比特率 128000 --language 语言增强 - --subtitles 包含字幕时间轴 - --pronunciation 自定义发音 -

查看音色列表：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 [flags]

参数 --message 消息内容 --model 模型选择 --stream 流式输出

# 简单对话 mmx text chat --message "帮我生成一首关于AI的4言诗" # 流式输出 mmx text chat --message "解释量子计算" --stream

网络搜索 mmx search query