前言说明
饺子配音依托 Edge TTS 技术,为用户提供免费语音合成功能。我们基于该技术开发了专属 API 接口,目前该接口仅对会员用户开放,普通用户暂不支持调用接口服务,会员使用接口服务不会二次扣费,也无其他限制。若您需要免费合成语音,可直接通过本站在线工具操作,无需额外权限。如需使用 API 功能,欢迎升级为本站会员,会员可解锁更多高效语音合成场景。
使用说明
语音合成接口
接口地址(支持 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 |
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。


评论(0)