文本合成语音api接口文档
API 文档
1. 文本转语音接口
请求 URL: /tts
请求方法: POST
请求头:
Content-Type: application/json
请求参数:
| 参数名 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| text | string | 是 | 需要转换的文本 |
| voice | string | 否 | 语音标识符，默认值为xiaoyi |
请求示例:
{
"text": "你好，这是一个测试。",
"voice": "xiaoyi"
}
成功响应:
-
状态码:
200 OK -
响应格式:
{ "message": "文本转语音转换成功", "file_name": "随机生成的文件名", "download_url": "/download/随机生成的文件名" }错误响应:
- 状态码:
400 Bad Request - 响应格式:
- 状态码:
{
"error": "文本是必需的"
}
- 状态码:
500 Internal Server Error - 响应格式:
{
"error": "错误信息"
}
语音标识符说明
| 简短标识符 | 对应语音值 | 性别 | 中文名字 | 描述 |
|---|---|---|---|---|
| xiaoyi | zh-CN-XiaoyiNeural | 女 | 小怡 | 适合日常对话，声音清晰 |
| xiaomei | zh-CN-XiaomeiNeural | 女 | 小梅 | 甜美的女性声音 |
| jessa | en-US-JessaNeural | 女 | 杰莎 | 自然、流畅的英语声音 |
| guy | en-US-GuyNeural | 男 | 盖伊 | 适合多种场景的男性声音 |
| zhangli | zh-CN-ZhangLiNeural | 男 | 张力 | 低沉且有磁性的声音 |
| lisa | en-AU-LisaNeural | 女 | 丽莎 | 澳大利亚英语的女性声音 |
| liang | zh-CN-LiangNeural | 男 | 梁 | 清晰、稳重的男声 |
| pat | en-GB-PatNeural | 男 | 派特 | 英国口音的男性声音 |
文件下载接口
请求 URL: /download/<filename>
请求方法: GET
路径参数:
| 参数名 | 类型 | 描述 |
|---|---|---|
| filename | string | 要下载的音频文件名 |
成功响应:
- 状态码:
200 OK - 响应: 返回音频文件。
错误响应:
- 状态码:
500 Internal Server Error - 响应格式:
{
"error": "文件下载失败: 错误信息"
}
注意事项
- 确保在请求中提供有效的文本。
- 返回的文件名为随机生成，并会在 24 小时后自动清理。
- 在选择语音时，可根据性别和语言类型选择适合的标识符。