用途
mmx-cli 是一个终端命令行工具，用于通过 MiniMax AI 平台生成与检查文本、图像、视频、语音、音乐、网络搜索结果及 MiniMax API 资源。当用户希望借助 mmx 终端 CLI 完成上述媒体内容创作或 API 资源操作时，可使用该技能。
安装与认证
安装命令：
npm install -g mmx-cli
认证方式支持 OAuth 与 API key。OAuth 凭据持久化到 ~/.mmx/credentials.json，API key 持久化到 ~/.mmx/config.json：
mmx auth login --api-key sk-xxxxx
查看当前生效的认证来源：
mmx auth status
也可在单次调用中传入 API key：
mmx text chat --api-key sk-xxxxx --message "Hello"
区域会自动检测，可通过 --region global 或 --region cn 覆盖。
智能体标志
在非交互（智能体/CI）环境中建议始终使用以下标志：
| 标志 | 用途 |
|---|---|
--non-interactive |
缺少参数时立即失败，而非提示输入 |
--quiet |
抑制加载动画与进度，stdout 为纯数据 |
--output json |
机器可读的 JSON 输出 |
--async |
立即返回任务 ID（视频生成） |
--dry-run |
预览 API 请求而不执行 |
--yes |
跳过确认提示 |
主要命令
文本对话 text chat
聊天补全，默认模型为 MiniMax-M3；如需复现旧版输出，可传 --model MiniMax-M2.7 使用上一代默认模型。支持单条消息、多轮对话加系统提示、从文件读取消息。
mmx text chat --message <text> [flags]
mmx text chat --message "user:What is MiniMax?" --output json --quiet
mmx text chat \
--system "You are a coding assistant." \
--message "user:Write fizzbuzz in Python" \
--output json
mmx text chat --model MiniMax-M2.7 --message "user:Hello" --output json
cat conversation.json | mmx text chat --messages-file - --output json
图像生成 image generate
用于文生图任务，如缩略图、概念图、社交视觉素材与提示词快速迭代。模型为 image-01。
mmx image generate --prompt <text> [flags]
mmx image generate --prompt "A cat in a spacesuit" --output json --quiet
mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet
mmx image generate --prompt "Product hero image" --region global --output json --quiet
mmx image generate --prompt "Product hero image" --region cn --output json --quiet
智能体注意事项：当结果会被其他工具解析时，优先使用 --output json --quiet --non-interactive；在验证参数或 CI 示例时，可在调用 API 前先使用 --dry-run；将生成的媒体保存在任务本地输出目录，并在复用返回的文件路径或 URL 前进行校验。
视频生成 video generate
默认模型为 MiniMax-Hailuo-2.3。这是异步任务，默认轮询直到完成。
mmx video generate --prompt <text> [flags]
mmx video generate --prompt "A robot." --async --quiet
mmx video generate --prompt "Ocean waves." --download ocean.mp4 --quiet
语音合成 speech synthesize
文本转语音，默认模型为 speech-2.8-hd，最多 10k 字符。
mmx speech synthesize --text <text> [flags]
mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet
echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3
音乐生成 music generate
模型为 music-2.6-free。
mmx music generate --prompt <text> [--lyrics <text>] [flags]
mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3 --quiet
mmx music generate --prompt "Upbeat pop about summer" --lyrics-optimizer --out summer.mp3 --quiet
网络搜索 search query
通过 MiniMax 进行网络搜索。
mmx search query --q "MiniMax AI" --output json --quiet
图像理解 vision describe
通过 VLM 进行图像理解。
mmx vision describe --image photo.jpg --prompt "What breed?" --output json
管道组合示例
# 生成图像 → 描述该图像
URL=$(mmx image generate --prompt "A sunset" --quiet)
mmx vision describe --image "$URL" --quiet
# 异步视频工作流
TASK=$(mmx video generate --prompt "A robot" --async --quiet | jq -r '.taskId')
mmx video task get --task-id "$TASK" --output json
mmx video download --task-id "$TASK" --out robot.mp4
退出码
| 码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 一般错误 |
| 2 | 用法错误 |
| 3 | 认证错误 |
| 4 | 配额超限 |
| 5 | 超时 |
| 10 | 触发内容过滤 |
限制
需要已配置的 MiniMax 账号与有效认证，否则任何依赖 API 的命令都无法工作。媒体生成任务可能是异步的、受配额限制或受区域约束；智能体应显式处理延迟完成与提供方侧失败。该技能仅记录 CLI 用法，不替代提供方政策审查、内容安全检查或下游文件校验。