文本合成语音api接口文档

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 小时后自动清理。
  • 在选择语音时,可根据性别和语言类型选择适合的标识符。
相关推荐
IT_陈寒2 小时前
React 18实战:7个被低估的Hooks技巧让你的开发效率提升50%
前端·人工智能·后端
逛逛GitHub3 小时前
飞书多维表“独立”了!功能强大的超出想象。
人工智能·github·产品
机器之心3 小时前
刚刚,DeepSeek-R1论文登上Nature封面,通讯作者梁文锋
人工智能·openai
aneasystone本尊6 小时前
学习 Chat2Graph 的知识库服务
人工智能
IT_陈寒6 小时前
Redis 性能翻倍的 7 个冷门技巧,第 5 个大多数人都不知道!
前端·人工智能·后端
飞哥数智坊16 小时前
GPT-5-Codex 发布,Codex 正在取代 Claude
人工智能·ai编程
倔强青铜三17 小时前
苦练Python第46天:文件写入与上下文管理器
人工智能·python·面试
虫无涯17 小时前
Dify Agent + AntV 实战:从 0 到 1 打造数据可视化解决方案
人工智能
Dm_dotnet19 小时前
公益站Agent Router注册送200刀额度竟然是真的
人工智能
算家计算20 小时前
7B参数拿下30个世界第一!Hunyuan-MT-7B本地部署教程:腾讯混元开源业界首个翻译集成模型
人工智能·开源