MiniMax CLI v1.0.4：改名 mmx、音乐生成结构化参数与配置体系重构

一句话结论

MiniMax 官方命令行工具在 v1.0.4（2026-04-08 发布）完成了一次「名字与底座」的双重升级：所有命令从 minimax 统一改名为更短的 mmx；音乐生成命令补齐了曲风、乐器、人声等结构化参数；认证凭据改为仅从文件读取并支持交互式初始化；配置文件写入改为原子操作防损坏，全局错误拦截覆盖文件系统、网络与格式三类错误。这一版是 CLI 从早期版本走向稳定工具的关键节点，19 个 PR 里一半以上在修可靠性。本站此前介绍过这个工具的七类核心命令与 v1.0.13 之后的功能增量，本文聚焦 v1.0.4 这一版的变更。

命令改名：从 minimax 到 mmx

PR #50 把 CLI 的根命令从 minimax 改为 mmx。改名后 mmx text chat、mmx image generate 等命令保持原功能不变，只是前缀更短、终端输入更快。对已经装过旧版的用户，全局命令需要重新链接一次；新装用户不受影响。官方同步更新了技能文档（PR #37）与 README 中的示例命令，保证文档与 CLI 行为一致。

音乐生成：结构化参数上线

PR #34 给音乐生成命令加入了一组结构化 flag，替代此前只能靠自然语言描述的方式。写歌时可以在命令行直接指定曲风、乐器配置、是否要人声、音频时长等维度，不用再把所有要求塞进一句提示词。PR #37 同步把技能文档里的音乐参数表与 CLI 实现对齐，编程智能体装技能后能直接引用这份参数表生成命令。

对做短视频配乐、播客片头的创作者，结构化参数的价值是可控性：同一句提示词下，改一个 flag 就能对比「纯器乐版」和「带人声版」的效果差异，脚本批量生成时也更稳定。

认证与配置体系重构

这一版对认证和配置动了三刀：

API Key 文件化（PR #27）：密钥不再从环境变量等多个位置读取，只从凭据文件读取，并支持交互式设置向导。密钥泄漏风险面收窄，CI/CD 场景挂载一个凭据文件即可。

配额面板（PR #51）：mmx auth login 成功后直接显示配额仪表盘，登录即知剩余额度，不用再单独跑 mmx quota 确认密钥是否生效。

配额端点迁移（PR #28）：查询配额的接口从 www 子域迁到 api 子域，修掉了配额查询失灵的问题。

可靠性方面还有一组密集修复：PR #36 让凭据与配置文件写入走「临时文件+重命名」的原子路径，进程中断不会留下半截配置；PR #35 加入全局错误拦截，文件系统、网络、格式三类错误统一给出可读提示而非堆栈崩溃；PR #39 允许全局 flag 放在命令名之前（mmx --region=cn text chat 这种写法从此合法）；PR #46 校验 MINIMAX_TIMEOUT 环境变量防止 NaN 崩溃；PR #42 修数值型 flag 默认值被 || 误吞为 0 的问题。

多模态输入与下载链路修复

图像相关命令修了两个实际使用中最容易踩的坑：

• URL 截断（PR #47）：--subject-ref 解析时 URL 会被截断，导致参考图引用失效；修复后完整 URL 正确传入。
• MIME 探测（PR #43）：上传图片时按文件扩展名探测 MIME 类型，避免部分格式被服务端拒收。

下载链路（PR #44）补齐了错误处理、背压控制与冲刷等待，大文件下载中途断网不再产出损坏的半截文件。Node.js 兼容性（PR #32）修复了文件上传与状态栏在部分 Node 版本上的异常。

对使用者的实际影响

这一版之后，工具的推荐使用方式定型：npm install -g mmx-cli 安装、mmx auth login 交互式配置、按模态选择命令族。三个后续版本（v1.0.5 到 v1.0.7）只做了文档、语音输出扩展名与重复文件清理，功能面没有再动，直到 v1.0.8 才带来下一批功能增量。

对在终端跑 AI 生成流水线的用户，v1.0.4 的核心价值是把「装上能用」升级成「坏了知道为什么」：原子写入、错误拦截、配额面板、超时校验这组修复共同把故障排查成本压了下来。

原文信息

• 作者：MiniMax（@MiniMax-AI），MiniMax 开放平台官方命令行工具仓库
• 开源协议：MIT
• 项目地址：MiniMax-AI/cli（ 原文地址：