song_kang_shuai
157 lines
4.0 KiB
Markdown
157 lines
4.0 KiB
Markdown
---
|
||
name: mmx
|
||
description: MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能
|
||
---
|
||
|
||
# MiniMax CLI 工具 (mmx)
|
||
|
||
## 功能概述
|
||
|
||
`mmx` 是 MiniMax 的命令行工具，支持文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索、图像理解等功能。
|
||
|
||
## 常用命令
|
||
|
||
### 1. 文本对话 (text chat)
|
||
```bash
|
||
# 基本对话
|
||
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)
|
||
|
||
**⚠️ 约束: 默认使用中文语音，中文优先于英文**
|
||
|
||
```bash
|
||
# 基本语音合成（默认使用中文语音 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)
|
||
```bash
|
||
# 基本图像生成
|
||
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)
|
||
```bash
|
||
# 描述本地图片
|
||
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)
|
||
```bash
|
||
# 文本生成视频 (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)
|
||
```bash
|
||
# 生成音乐
|
||
mmx music generate --prompt "轻松愉快的钢琴曲"
|
||
|
||
# 生成歌曲
|
||
mmx music generate --prompt "一首关于爱情的流行歌曲"
|
||
```
|
||
|
||
### 7. 网页搜索 (search query)
|
||
```bash
|
||
# 基本搜索
|
||
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 模式) |
|
||
|
||
## 查看配额
|
||
```bash
|
||
mmx auth status
|
||
```
|
||
|
||
## 帮助命令
|
||
```bash
|
||
mmx --help # 全局帮助
|
||
mmx <resource> --help # 资源帮助
|
||
mmx text chat --help # 命令帮助
|
||
```
|