Podcast 播客生成接口
生成双说话人播客风格的对话音频。支持 5 组预设音色组合，也可上传自定义音色。
接口信息
- 接口路径:
/v1/audio/podcast - 请求方式:
POST - 认证方式: Header 中的
X-API-Key
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Key | string | 是 | 应用密钥 |
注意：X-API-Key 用于验证账户信息，进入 控制台 → 项目空间，选择对应项目，左侧导航进入「API Key 管理」即可创建/查看。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| dialogueText | string | 是 | 对话文本，每行一句，Speaker 1 与 Speaker 2 交替。最大 4000 字符 |
| pairSelection | string | 否 | 音色组合名称，默认 Lex & Musk。可选值见下表。若同时提供两路自定义音色则传 Custom |
| audioPromptSpk1 | string | 否 | Speaker 1 自定义音色的音频 URL（公开可访问），与 audioPromptSpk2 同时提供时生效 |
| audioPromptSpk2 | string | 否 | Speaker 2 自定义音色的音频 URL（公开可访问），与 audioPromptSpk1 同时提供时生效 |
| speed | number | 否 | 语速，范围 200~500，默认 250 |
预设音色组合
| pairSelection | 说明 |
|---|---|
| Lex & Musk | 男性对话组合（默认） |
| Ava & Andrew | 女性 + 男性组合 |
| Emma & Steffan | 女性 + 男性组合 |
| GMale & GFemale | 通用男 + 通用女 |
| YoungFemale & YoungMale | 年轻女 + 年轻男 |
请求示例
curl -X POST https://api.vuilabs.cn/v1/audio/podcast \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"dialogueText": "Have you tried the new AI tool?\nYes, it is amazing for productivity.\nI agree, it saves hours every day.",
"pairSelection": "Lex & Musk",
"speed": 250
}'
自定义音色示例
curl -X POST https://api.vuilabs.cn/v1/audio/podcast \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"dialogueText": "Hello, welcome to our show.\nThank you for having me.",
"pairSelection": "Custom",
"audioPromptSpk1": "https://example.com/speaker1.wav",
"audioPromptSpk2": "https://example.com/speaker2.wav",
"speed": 300
}'
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| audioUrl | string | 生成的音频文件 URL（签名 URL，有效期 1 小时） |
| objectKey | string | 音频文件标识，可用于水印下载接口 |
| durationSec | number | 音频时长（秒） |
| traceId | string | 请求追踪 ID，联系支持时请提供 |
响应示例
{
"data": {
"audioUrl": "https://vuilab-res-sign.oss-cn-hangzhou.aliyuncs.com/podcastResult/xxx.wav?Expires=...",
"objectKey": "podcastResult/xxx.wav",
"durationSec": 33.0,
"traceId": "e35afb0276751b573aa4cd4a6fa88c79"
},
"error_code": 0,
"error_message": "",
"succeed": true
}
错误码
| error_code | 说明 |
|---|---|
| 0 | 成功 |
| 10001 | 参数错误（文本为空或超长、音色 URL 不在白名单等） |
| 10003 | 未授权（密钥无效） |
| 10006 | 请求超时 |
| 10014 | 连接数限制（全局 2 RPS / 用户 5 RPM） |
| 10015 | 内容安全拦截 |
| 20003 | 余额不足 |
| 10000 | 生成处理失败，请查看 error_message；持续失败请联系支持 |
计费说明
具体计费规则、价格和免费额度请参见 产品计费。
注意事项
dialogue_text每行为一句对话，奇数行为 Speaker 1，偶数行为 Speaker 2- 自定义音色需同时提供
audioPromptSpk1和audioPromptSpk2，仅提供一个无效 - 音色 URL 必须为 HTTPS 且在平台白名单内
- 生成的音频 URL 为签名 URL，有效期 1 小时，请及时下载