---
name: mmx
description: MiniMax CLI 工具，提供文本对话、语音合成、图像生成、视频生成、音乐生成、网页搜索等 AI 功能
---

# MiniMax CLI 工具 (mmx)

## 安装与初始化

如果用户未安装 `mmx`，需要引导用户完成安装和登录：

### 1. 安装 mmx-cli

```bash
npm install -g mmx-cli
```

### 2. 登录 API Key

使用你的 API Key 完成鉴权（用户可选择以下任一方式）：

**方式一：用户直接提供 Key**
- 用户告诉我 API Key（如 `sk-xxxxx`）
- 我执行：`mmx auth login --api-key sk-xxxxx`

**方式二：交互式登录**
- 执行：`mmx auth login`
- 用户在终端手动输入 API Key

### 3. 验证登录状态

```bash
mmx auth status
```

---

## 功能概述

`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  # 命令帮助
```