API 文档
1. 文本转语音接口
请求 URL : /tts
请求方法 : POST
请求头:
Content-Type: application/json
请求参数:
参数名 | 类型 | 是否必需 | 描述 |
---|---|---|---|
text | string | 是 | 需要转换的文本 |
voice | string | 否 | 语音标识符,默认值为xiaoyi |
请求示例:
json
{
"text": "你好,这是一个测试。",
"voice": "xiaoyi"
}
成功响应:
-
状态码 :
200 OK
-
响应格式:
json{ "message": "文本转语音转换成功", "file_name": "随机生成的文件名", "download_url": "/download/随机生成的文件名" }
错误响应:
- 状态码 :
400 Bad Request
- 响应格式:
- 状态码 :
json
{
"error": "文本是必需的"
}
- 状态码 :
500 Internal Server Error
- 响应格式:
json
{
"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
- 响应格式:
json
{
"error": "文件下载失败: 错误信息"
}
注意事项
- 确保在请求中提供有效的文本。
- 返回的文件名为随机生成,并会在 24 小时后自动清理。
- 在选择语音时,可根据性别和语言类型选择适合的标识符。