MiniMax TTS（文本转语音）

⚠️ 需要具备 TTS/语音合成权限的 MiniMax API 密钥

• - 编程计划密钥（sk-cp-xxx）→ 不支持 TTS，仅限 M2.7 聊天模型
• 通用 API 密钥 → 请在 MiniMax 开放平台 确认您的订阅是否包含语音合成
• TTS 独立套餐: 访问 MiniMax 语音合成产品

使用 MiniMax 语音合成 API 进行文本转语音。支持 40+ 种语言、多种音色、可调节语速/音调以及多种音频格式。

---

设置

1. 配置 API 密钥

bash
openclaw config set skills.entries.minimax-tts.apiKey sk-your-key

或添加到 openclaw.json 的技能条目中：

json
{
skills: {
entries: {
minimax-tts: {
apiKey: sk-your-key
}
}
}
}

2. 依赖安装

bash
pip install requests

---

架构

~/.openclaw/workspace/skills/minimax-tts/
├── SKILL.md
├── _meta.json
└── scripts/
└── minimax_tts.py

---

使用方法

终端使用

bash

基础 TTS - 文本转语音

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py 你好，欢迎使用 MiniMax 语音合成

选择音色

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py Hello world --voice female-shaonv

调整语速和音调

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py 快速播报新闻 --speed 1.5 --pitch 2

保存到文件

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py 输出到文件 --output speech.mp3

列出可用音色

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py --list-voices

多段落（多音色有声书/播客）

MINIMAXAPIKEY=sk-your-key python3 scripts/minimax_tts.py --segments segments.json --output combined.mp3

代码调用

python
from minimaxtts import generatespeech

基础 TTS

result = generatespeech(text=你好世界, voice=female-shaonv, outputpath=hello.mp3)

带选项

result = generate_speech( text=这是一段测试语音, model=speech-2.8-hd, voice=female-tianmei, speed=1.0, pitch=0, audio_format=mp3, output_path=test.mp3 )

---

工具定义

名称: minimax_tts

输入模式:
json
{
type: object,
properties: {
text: {
type: string,
description: 要转换为语音的文本（每次请求最多 10000 字符）
},
model: {
type: string,
enum: [speech-2.8-hd, speech-2.6-hd, speech-02-hd],
default: speech-2.8-hd,
description: TTS 模型：speech-2.8-hd（推荐，高质量带情感控制），speech-2.6-hd（不支持编程计划），speech-02-hd（紧凑高清语音）
},
voice: {
type: string,
default: female-tianmei,
description: 音色 ID：female-tianmei, female-shaonv, female-yujie, female-chengshu, male-qn-qingse, male-qn-jingying, male-qn-badao, male-qn-daxuesheng
},
speed: {
type: number,
default: 1.0,
minimum: 0.5,
maximum: 2.0,
description: 语速，范围 0.5-2.0，默认 1.0
},
pitch: {
type: number,
default: 0,
minimum: -12,
maximum: 12,
description: 音调调节，范围 -12 到 12，默认 0
},
audio_format: {
type: string,
enum: [mp3, wav, pcm],
default: mp3,
description: 输出音频格式
},
output_path: {
type: string,
description: 音频保存路径。默认保存到 ~/.openclaw/workspace/tmp/tts_<时间戳>.mp3
}
},
required: [text]
}

输出: 包含成功状态和音频文件路径的 JSON

---

常用音色 ID

voice_id	描述	性别
female-tianmei	甜美女声	女
female-shaonv

少女音 | 女 |
| female-yujie | 御姐音色 | 女 |
| female-chengshu | 成熟女性 | 女 |
| male-qn-qingse | 青年男声（青涩） | 男 |
| male-qn-jingying | 青年男声（精英） | 男 |
| male-qn-badao | 青年男声（霸道） | 男 |
| male-qn-daxuesheng | 青年大学生 | 男 |

---

多段落生成（有声书/播客）

对于多角色内容，创建 segments.json 文件并使用 --segments：

bash
python3 scripts/minimax_tts.py --segments segments.json --output combined.mp3

segments.json 格式

json
[
{
text: 清晨的阳光洒进了房间。,
voice: female-tianmei,
speed: 1.0
},
{
text: 欢迎收听今天的节目。,
voice: male-qn-qingse,
speed: 1.0
}
]

---

错误码

代码	含义
0	成功
1002

频率限制 - 请稍后重试 |
| 1004 | 认证失败 - 检查 API 密钥 |
| 1008 | 余额不足 |
| 1026 | 内容违规 |
| 2013 | 参数错误 |
| 2049 | 无效的 API 密钥 |