MiniMax AI 开放平台官方命令行工具
专为 AI Agent 打造。在任意 Agent 或终端中生成文字、图像、视频、语音和音乐。
- 文本对话 — 多轮对话、流式输出、系统提示词、JSON 格式输出
- 图像生成 — 文生图，支持比例和批量控制
- 视频生成 — 异步生成，进度追踪
- 语音合成 — 30+ 音色、语速调节、流式播放
- 音乐生成 — 文生音乐，支持自定义歌词、纯音乐、自动生词，以及基于参考音频的 Cover 生成
- 图像理解 — 图片描述与识别
- 网络搜索 — MiniMax 搜索引擎
- 双区域 — 国际版（
api.minimax.io）和国内版（api.minimaxi.com）自动切换
# AI Agent 使用（OpenClaw、Cursor、Claude Code 等）：添加 Skill 到你的 Agent
npx skills add MiniMax-AI/cli -y -g
# 或全局安装 CLI 在终端中使用
npm install -g mmx-cli需要 Node.js 18+
# 认证（交互式 — 选 MiniMax OAuth 或粘 API Key）
mmx auth login
# 或者非交互
mmx auth login --api-key sk-xxxxx
# 开始创作
mmx text chat --message "你好，MiniMax！"
mmx image "一只穿宇航服的猫"
mmx speech synthesize --text "你好！" --out hello.mp3
mmx video generate --prompt "海浪拍打礁石"
mmx music generate --prompt "欢快的流行乐" --lyrics "[主歌] 啦啦啦，阳光照"
mmx search "MiniMax AI 最新动态"
mmx vision photo.jpg
mmx quotammx text chat --message "写一首诗"
mmx text chat --model MiniMax-M3 --message "你好" --stream
mmx text chat --system "你是编程助手" --message "用 Go 写 Fizzbuzz"
mmx text chat --message "user:你好" --message "assistant:嗨！" --message "你叫什么名字？"
cat messages.json | mmx text chat --messages-file - --output jsonmmx image "一只穿宇航服的猫"
mmx image generate --prompt "科技感 Logo" --n 3 --aspect-ratio 16:9
mmx image generate --prompt "山水画" --out-dir ./output/# Hailuo-2.3（视频生成 V1）
mmx video generate --prompt "海浪拍打礁石" --download sunset.mp4
mmx video generate --prompt "机器人作画" --async
# MiniMax-H3（视频生成 V2）
mmx video generate --api-key "$MINIMAX_API_KEY" --model MiniMax-H3 --prompt "夕阳下的海浪"
mmx video generate --api-key "$MINIMAX_API_KEY" --model MiniMax-H3 --prompt "主体向前行走" --image start.jpg
mmx video generate --api-key "$MINIMAX_API_KEY" --model MiniMax-H3 --prompt "保持相同角色和动作" --reference-image character.png --reference-video motion.mp4
mmx video task get --task-id 123456
mmx video task get --task-id 424010985738629 --model MiniMax-H3
mmx video download --file-id 176844028768320 --out video.mp4MiniMax-H3 会在发送前检查本地文件和 Base64 数据：图片不超过 30 MB、参考视频不超过 50 MB、参考音频不超过 15 MB、JSON 请求体总计不超过 64 MB。所有素材的尺寸、宽高比、时长、帧率和编码格式仍由 API 服务端校验。
--region 是 CLI 原有的全局选项，不是 H3 参数。正常生成视频无需填写，CLI 会使用已保存或自动识别的区域。H3 默认使用 2K、5 秒，文生视频默认比例为 16:9。
mmx speech synthesize --text "你好！" --out hello.mp3
mmx speech synthesize --text "流式输出" --stream | mpv -
mmx speech synthesize --text "Hi" --voice English_magnetic_voiced_man --speed 1.2
echo "头条新闻" | mmx speech synthesize --text-file - --out news.mp3
mmx speech voices# 带歌词生成
mmx music generate --prompt "欢快的流行乐" --lyrics "[主歌] 啦啦啦，阳光照" --out song.mp3
# 自动生成歌词
mmx music generate --prompt "忧郁的独立民谣，雨夜" --lyrics-optimizer --out song.mp3
# 纯音乐（无人声）
mmx music generate --prompt "史诗管弦乐" --instrumental --out bgm.mp3
# Cover — 基于参考音频生成翻唱版本
mmx music cover --prompt "爵士钢琴，慵懒女声" --audio-file original.mp3 --out cover.mp3
mmx music cover --prompt "民谣吉他" --audio https://example.com/song.mp3 --out cover.mp3mmx vision photo.jpg
mmx vision describe --image https://example.com/img.jpg --prompt "这是什么品种的狗？"
mmx vision describe --file-id file-123mmx search "MiniMax AI"
mmx search query --q "最新动态" --output json
/v1/coding_plan/search接口单次最多返回 10 条结果，目前不支持翻页参数（参见 #107）。如需不同结果，请调整查询关键词。
mmx auth login # 交互式：选 OAuth (Global / 中国) 或粘 API Key
mmx auth login --api-key sk-xxxxx # 直接保存 API Key
mmx auth login --recommend # 跳过 3 选 1 菜单，弹出 region 选择器
mmx auth login --recommend --region=global # 直接 OAuth → api.minimax.io
mmx auth login --recommend --region=cn # 直接 OAuth → api.minimaxi.com
mmx auth status
mmx auth refresh
mmx auth logout请使用 mmx auth status 作为认证状态的权威检查方式。OAuth 与 API Key 凭据
都保存在 ~/.mmx/config.json 里，两者互斥 —— 用一种登录会清掉另一种。
也可以每次通过 --api-key 直接传入。使用 API Key 登录时，会自动同时探测
Global 与中国两个 region，选用能通过的那个。
mmx quota
mmx config show
mmx config set --key region --value cn
mmx config set --key default-text-model --value MiniMax-M3
mmx config export-schema | jq .mmx update
mmx update latest