4.0 KiB
4.0 KiB
name, description
| name | description |
|---|---|
| mmx | MiniMax CLI 工具,提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能 |
MiniMax CLI 工具 (mmx)
功能概述
mmx 是 MiniMax 的命令行工具,支持文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等功能。
常用命令
1. 文本对话 (text chat)
# 基本对话
mmx text chat --message "你好"
# 带系统提示词
mmx text chat --system "你是一个专业的程序员" --message "写一个快速排序"
# 多轮对话
mmx text chat --message "Hello" --message "How are you?"
# 指定模型
mmx text chat --model MiniMax-M2-7 --message "Hello"
# 输出 JSON 格式
mmx text chat --message "Hello" --output json
2. 语音合成 (speech synthesize)
⚠️ 约束: 默认使用中文语音,中文优先于英文
# 基本语音合成(默认使用中文语音 Chinese (Mandarin)_Warm_Girl)
mmx speech synthesize --text "你好,世界"
# 保存到文件
mmx speech synthesize --text "你好" --out hello.mp3
# 指定中文语音
mmx speech synthesize --text "你好" --voice "Chinese (Mandarin)_Warm_Girl"
# 指定英文语音(需要明确指定)
mmx speech synthesize --text "Hello" --voice English_expressive_narrator
# 查看所有可用语音
mmx speech voices
中文语音列表(中文 TTS 必须使用以下语音):
Chinese (Mandarin)_Warm_Girl- 温暖女孩(默认)Chinese (Mandarin)_Sweet_Lady- 甜蜜女士Chinese (Mandarin)_Kind-hearted_Antie- 善良阿姨Chinese (Mandarin)_Gentle_Youth- 温柔青年Chinese (Mandarin)_Gentleman- 绅士Chinese (Mandarin)_Reliable_Executive- 可靠主管Chinese (Mandarin)_News_Anchor- 新闻主播Chinese (Mandarin)_Humorous_Elder- 幽默长辈Chinese (Mandarin)_Lyrical_Voice- 抒情嗓音
英文语音列表:
English_expressive_narrator- 英文旁白
3. 图像生成 (image generate)
# 基本图像生成
mmx image generate --prompt "一只可爱的猫"
# 指定宽高比
mmx image generate --prompt "风景画" --aspect-ratio 16:9
# 生成多张
mmx image generate --prompt "Logo" --n 3
# 保存到文件
mmx image generate --prompt "山水画" --out /tmp/landscape.jpg
# 指定尺寸 (512-2048, 8的倍数)
mmx image generate --prompt "宽图" --width 1920 --height 1080
# 使用提示词优化
mmx image generate --prompt "猫" --prompt-optimizer
4. 图像理解 (vision describe)
# 描述本地图片
mmx vision describe --image photo.jpg
# 描述网络图片
mmx vision describe --image https://example.com/photo.jpg
# 自定义问题
mmx vision describe --image photo.jpg --prompt "这张图里有什么动物?"
5. 视频生成 (video generate)
# 文本生成视频 (T2V)
mmx video generate --prompt "一个人在海边跑步"
# 图片生成视频 (I2V)
mmx video generate --prompt "风景动画" --first-frame image.jpg
# 查看任务状态
mmx video task get <task_id>
# 下载视频
mmx video download <file_id>
6. 音乐生成 (music generate)
# 生成音乐
mmx music generate --prompt "轻松愉快的钢琴曲"
# 生成歌曲
mmx music generate --prompt "一首关于爱情的流行歌曲"
7. 网页搜索 (search query)
# 基本搜索
mmx search query --q "MiniMax AI 最新消息"
# JSON 输出
mmx search query --q "天气" --output json
全局选项
| 选项 | 说明 |
|---|---|
--api-key <key> |
API 密钥 |
--region <region> |
区域: global (默认), cn |
--output <format> |
输出格式: text, json |
--quiet |
静默模式,不显示非必要输出 |
--verbose |
显示 HTTP 请求/响应详情 |
--timeout <seconds> |
超时时间 (默认 300) |
--no-color |
禁用颜色 |
--non-interactive |
非交互模式 (CI/agent 模式) |
查看配额
mmx auth status
帮助命令
mmx --help # 全局帮助
mmx <resource> --help # 资源帮助
mmx text chat --help # 命令帮助