前言说明

饺子配音依托 Edge TTS 技术,为用户提供免费语音合成功能。我们基于该技术开发了专属 API 接口,目前该接口仅对会员用户开放,普通用户暂不支持调用接口服务,会员使用接口服务不会二次扣费,也无其他限制。若您需要免费合成语音,可直接通过本站在线工具操作,无需额外权限。如需使用 API 功能,欢迎升级为本站会员,会员可解锁更多高效语音合成场景。

Edge_TTS_语音合成 API文档 1

使用说明

语音合成接口

接口地址(支持 POST)

https://www.jiaozitts.com/api/v1/edge_tts

请求头

字段名 类型 必填 描述
Authorization string Bearer Token
Content-Type string application/json

示例

Content-Type: application/json
Authorization: Bearer API-KEY  // API密钥

注意:秘钥请登录后前往 https://www.jiaozitts.com/user/api/ 生成,接口秘钥支持访问本站所有接口服务!

请求参数

参数名 类型 必填 描述 约束条件 示例值
text string 需要合成的文本内容 最大2000个字符 "你好世界"
voice string 语音类型选择 音色名 "zh-CN-XiaoxiaoNeural"
rate integer 语速调节 -100 ~ 100 0
pitch integer 音调调节 -100 ~ 100 0
volume integer 音量调节 -100 ~ 100 0
stream boolean 是否启用流式传输 true/false true

请求示例

{
  "text": "欢迎使用Edge TTS语音合成服务,这是一个测试文本。",
  "voice": "zh-CN-XiaoxiaoNeural",
  "rate": 5,
  "pitch": 0,
  "volume": 10,
  "stream": true
}

返回参数说明

字段名 类型 说明 示例
code Integer 状态代码 200
status String 执行状态 success
msg String 状态信息 合成成功
audio_url URL 音频文件地址 https://www.jiaozitts.com/.../68269e2ea4595_1747361326.mp3
format String 音频格式 mp3

返回示例

{
    "code": 200,
    "status": "success",
    "msg": "合成成功",
    "audio_url": "https://www.jiaozitts.com/wp-content/uploads/2025/05/68268f6256c69_1747357538.mp3",
    "format": "mp3"
}

秘钥错误

{
    "code": 401,
    "msg": "API密钥无效或已过期!"
}

权限不足

{
    "code": 403,
    "error": "insufficient_privileges",
    "message": "合成失败:权限不足,请升级为会员或永久会员!"
}

参数错误

{
    "code": 404,
    "msg": "无效的 voice 参数"
}

合成失败

{
    "code": 201,
    "msg": "合成失败"
}

请求示例 (CURL)

# 基本调用(使用默认参数)
curl -X POST \
     -H "Authorization: Bearer 68985a242e655fb2d0194dfb478f1f76" \
     -H "Content-Type: application/json" \
     -d '{"text":"你好世界","voice":"zh-CN-XiaoxiaoNeural"}' \
     https://www.jiaozitts.com/api/v1/edge_tts

# 带完整参数调用
curl -X POST \
     -H "Authorization: Bearer 68985a242e655fb2d0194dfb478f1f76" \
     -H "Content-Type: application/json" \
     -d '{"text":"欢迎使用语音合成服务","voice":"zh-CN-YunxiNeural","rate":20,"pitch":-10,"volume":5,"stream":true}' \
     https://www.jiaozitts.com/api/v1/edge_tts

音色查询接口

提供底层的音色查询功能
接口地址(支持 POST)
https://www.jiaozitts.com/api/v1/edge_voices

请求头

字段名 类型 必填 描述
Authorization string Bearer Token
Content-Type string application/json

示例

Content-Type: application/json
Authorization: Bearer API-KEY  // API密钥

请求参数

该接口支持空请求体,也可以传递额外参数来过滤音色列表。

参数名 类型 必填 描述 示例值
[custom_param] any 自定义过滤参数 {"language": "zh-CN"}

返回数据

{
  "code": 200,
  "message": "获取音色列表成功",
  "data": {
    "voices": [
      {
        "name": "Microsoft Server Speech Text to Speech Voice (zh-CN, XiaoxiaoNeural)",
        "short_name": "zh-CN-XiaoxiaoNeural",
        "locale": "zh-CN",
        "gender": "Female",
        "sample_rate_hertz": "24000",
        "voice_type": "Neural",
        "status": "GA"
      },
      {
        "name": "Microsoft Server Speech Text to Speech Voice (zh-CN, YunxiNeural)",
        "short_name": "zh-CN-YunxiNeural",
        "locale": "zh-CN",
        "gender": "Male",
        "sample_rate_hertz": "24000",
        "voice_type": "Neural",
        "status": "GA"
      }
      // 更多音色...
    ],
    "count": 2  // 音色总数
  }
}

请求示例 (CURL)

# 基本调用(获取所有音色)
curl -X POST "https://www.jiaozitts.com/api/v1/edge_voices" \
  -H "Authorization: Bearer sk-7896exxxxxxxxxcbb97e656a0876e7" \
  -H "Content-Type: application/json"

# 带过滤参数调用
curl -X POST "https://www.jiaozitts.com/api/v1/edge_voices" \
  -H "Authorization: Bearer sk-7896exxxxxxxxxcbb97e656a0876e7" \
  -H "Content-Type: application/json" \
  -d '{"language": "zh-CN"}'

状态码说明

状态码 错误码 错误信息 描述
200 - 成功 请求成功
400 json_decode_failed JSON解析失败: [具体错误] 请求体JSON格式错误
400 empty_text 请输入有效文本! text参数为空
400 empty_voice 请选择语音类型! voice参数为空
400 text_too_long 文本长度不能超过2000个字符! text参数超过长度限制
400 invalid_voice voice 参数无效,请检查! voice参数格式错误
400 invalid_parameters rate、pitch 或 volume 参数无效,请检查! 音参数格式错误
401 rest_invalid_auth Authorization头格式错误 缺少或无效的Bearer Token
403 insufficient_privileges 合成失败:权限不足,请升级为会员或永久会员! 用户权限不足
500 api_request_failed 合成失败: [具体错误] 请求Edge TTS服务失败
500 api_server_error 合成失败: 服务返回错误[状态码] Edge TTS服务返回错误状态码
500 response_parse_failed 合成失败: 解析响应失败 无法解析Edge TTS服务的响应
500 invalid_response_structure 合成失败: 响应结构无效 Edge TTS服务返回的响应格式不符合预期
500 directory_create_failed 生成失败: 无法创建上传目录 无法创建存储音频的目录
500 directory_not_writable 上传目录不可写 上传目录没有写权限
500 file_create_failed 文件创建失败 无法创建音频文件
500 empty_audio_file 合成失败: 生成的音频文件为空 生成的音频文件大小为0
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。