API 文档文字转语音
配音模型
查看文字转语音接口当前支持的 modelId、模型特点和选择建议。
配音模型
modelId 用于选择文字转语音的引擎和版本,voiceId 用于选择具体音色。调用同步或异步 TTS 接口时,建议同时传入这两个字段,让生成效果和计费模型保持明确。
当前支持的 modelId
modelId | 品牌 | 模型版本 | 适用方向 |
|---|---|---|---|
fishaudio-s21pro | Fish Audio | S2.1 Pro | 更高质量,适合正式内容生成 |
fishaudio-s21pro-flash | Fish Audio | S2.1 Pro Flash | 默认模型,更快且积分消耗更低 |
fishaudio-s2pro | Fish Audio | S2 Pro | S2 Pro 兼容工作流 |
fishaudio-s1 | Fish Audio | S1 | 兼容仍依赖 S1 的既有业务 |
minimax-2.8-turbo | MiniMax | Speech 2.8 Turbo | MiniMax 默认模型,侧重速度 |
minimax-2.8-hd | MiniMax | Speech 2.8 HD | 侧重更高质量的 MiniMax 输出 |
minimax-2.6-turbo | MiniMax | Speech 2.6 Turbo | 兼容 2.6 Turbo 工作流 |
minimax-2.6-hd | MiniMax | Speech 2.6 HD | 兼容 2.6 HD 工作流 |
qwen3-tts-flash | Qwen | TTS 3 Flash | 快速生成,适合 Qwen 音色 |
可用模型以 GET /api/openapi.json 返回的 TTS schema 为准。模型能力、账户权限或品牌可用性发生变化时,OpenAPI schema 是当前公开合同。
如何选择
- 优先选择与
voiceId所属品牌一致的modelId。例如 Fish Audio 音色搭配fishaudio-*模型。 - Fish Audio 未指定
modelId时默认使用fishaudio-s21pro-flash。 - MiniMax 未指定时默认使用
minimax-2.8-turbo;Qwen 未指定时默认使用qwen3-tts-flash。 - 同一段文本切换模型可能产生不同的音质、速度、情绪表现和积分消耗,批量生成前建议先用短文本试听。
请求示例
同步和异步 TTS 请求都使用 modelId:
{
"text": "你好,这是一段配音模型测试。",
"voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
"modelId": "fishaudio-s21pro-flash",
"format": "mp3",
"speed": 1
}接口对应关系
| 接口 | 模型字段 |
|---|---|
POST /api/open/v1/speech/tts | modelId |
POST /api/open/v1/speech/tts/jobs | modelId |
OpenAI 兼容接口 POST /v1/audio/speech | model |
接下来可以查看文字转语音(同步)、文字转语音(异步)或 OpenAI 兼容 TTS 的完整请求说明。