文本合成语音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 小时后自动清理。
• 在选择语音时，可根据性别和语言类型选择适合的标识符。