MiniMax CLI（mmx-cli）一键安装与基础使用指南

一句话，让你的 AI 助手拥有 MiniMax 全模态能力：视频、音乐、语音、图片、文本，一行命令搞定。

什么是 mmx-cli？

mmx-cli（也叫 MiniMax CLI）是 MiniMax 官方出的命令行工具，专为 AI Agent 场景设计。

不用写代码，直接在终端调用 MiniMax 的全模态能力，不过前提是你的Token Plan计划中支持相关模型调用：

能力	模型	说明
文本	MiniMax-M2.7	多轮对话、流式输出、JSON输出
图像	Image 01	文生图，支持比例、批量生成
视频	Hailuo 2.3	异步生成，支持查询和下载
语音	Speech 2.8	文字转语音，多音色可选
音乐	Music 2.6	文生音乐，支持歌词/纯音乐

输出文件默认保存在当前目录的 minimax-output/ 文件夹。

二、安装

2.1 前置要求

• Node.js >= 18
• npm

2.2 安装命令

npm install -g mmx-cli

2.3 登录 API Key

mmx auth login --api-key sk-xxxxx

把 sk-xxxxx 换成你的 Token Plan 密钥。

2.4 AI Agent安装

如果用了 OpenClaw、Hermes等, 直接把下面这句话发给它就行：

帮我安装 MiniMax CLI：https://github.com/MiniMax-AI/cli
我的密钥是 sk-cp-xxxxx

我这用的是29的基础套餐，没有视频和图片权限。

三、快速上手

3.1 查看面板

安装完成后，直接输入：

mmx

会显示当前可用资源、用量信息和帮助入口。

3.2 文本对话

mmx text chat --message "帮我生成一首关于AI的4言诗"

输出：

算力如海  
智慧如星  
机器觉醒  
共绘新天

3.3 生成图片

mmx image "赛博朋克风格的城市夜景，16:9"

生成的图片保存在 minimax-output/ 目录。

3.4 生成视频

mmx video generate --prompt "夕阳下，一只猫坐在窗边望向远方"

视频生成是异步的，命令会返回任务 ID，支持查询进度和下载。

3.5 生成音乐

mmx music generate --prompt "轻快爵士风格的歌曲，主题是夏天的海边" --out summer-jazz.mp3

3.6 语音合成

mmx speech synthesize --text "欢迎使用 MiniMax Token Plan" --out welcome.mp3

可选 --voice 参数指定音色。

3.7 Hermes中使用

直接发消息给Hermes就可以了，我们以生成一首音乐为例：

使用 mmx-cli工具，模仿 刘珂矣的《半壶纱》生成一首禅意中国风的歌曲

四、常用命令汇总

功能	命令
帮助	mmx --help
查看用量	mmx quota
文本对话	mmx text chat --message "..."
生成图片	mmx image "提示词"
生成视频	mmx video generate --prompt "..."
生成音乐	mmx music generate --prompt "..." --out xxx.mp3
语音合成	mmx speech synthesize --text "..." --out xxx.mp3
图像理解	mmx vision --file path/to/image.jpg

五、输出目录

所有生成的文件默认放在：

./minimax-output/

可以加 --out 参数指定输出路径和文件名。

六、听听生成的音乐的效果