深色模式
预置语音合成模型服务接口说明
接口地址：https://platform.wair.ac.cn/maas/v2/api
请求方式：POST/GET 请求
语音合成模型 Taichu-TTS
发音人列表api
请求说明
1. 路由：/get_speakers
2. 请求方法: GET
3. 请求参数: 无
返回说明
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| speakers | List[Object] | 发音人列表 |
| id | string | 发音人id, 合成时使用该id指定发音人 |
| name | string | 发音人名称，用于展示 |
返回json
{
"request_id": "",
"code": 0,
"message": "",
"speakers": [
{
"id": "mix_msvits_zhide_16k",
"name": "mix_msvits_zhide_16k"
},
{
"id": "mix_msvits_wangdan_16k",
"name": "王丹"
},
... ...
{
"id": "mix_tac_e_angry",
"name": "情感女声_愤怒"
}
]
}实时合成API
请求说明
- 路由: /tts
- 请求方法：POST、GET均支持
请求字段
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| request_id | string | 是 | 请求id，用户问题定位 |
| appkey | string | 是 | 产品的标识 |
| token | string | 否 | 用户校验token |
| text | string | 是 | 需要合成的文本 |
| format | string | 否 | 默认wav |
| sample_rate | int | 否 | 默认16000 |
| voice | string | 否 | 音色id，支持的音色列表可使用get_speakers API获取 |
| volumn | int | 否 | 音量，取值范围：0~100，默认值：50 |
| speed | int | 否 | 语速，取值范围：-500~500，默认值：0 |
| pitch | int | 否 | 语调，取值范围：-500~500，默认值：0 |
| enable_ts | int | 否 | 是否返回音频文本对齐时间戳, 默认关闭 |
请求json
{
"request_id": "2",
"appkey": "xxxx",
"token": "yyyy",
"text": "你好",
"format": "wav",
"sample_rate": 16000,
"voice": "zhichu",
"volumn": 50,
"speed": 50,
"pitch": 50,
"enable_ts": false
}返回说明
使用HTTPS GET方法和HTTPS POST方法请求的响应相同，响应结果都包含在HTTPS的响应体中。
响应内容为合成音频的二进制数据
长文本异步合成API
请求说明
1. 路由：/tts-long-commit
2. 请求方法: POST
请求字段
与实时合成API请求体相同
请求json
与实时合成API请求体相同
返回说明
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| request_id | string | 请求id，用户问题定位 |
| code | int | 0成功，其他表示错误 |
| message | string | 错误详细信息 |
| task_id | string | 任务提交成功后，返回的任务id，后续查询结果使用该id |
| audio_address | string | 合成完成之后的音频url地址 |
| task_status | string | 任务状态: created, running, complete, failed |
返回json
{
"request_id": "67",
"code": 0,
"message": "",
"task_id": "933b6d94-5902-4e7a-babf-6fa18c29ab87",
"audio_address": "",
"task_status": "created"
}长文本合成结果查询
请求说明
- 路由：/tts-long-query
- 请求方法: POST/GET
请求字段
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| request_id | string | 是 | 请求id，用户问题定位 |
| task_id | string | 是 | 任务提交成功后，返回的任务id，后续查询结果使用该id |
| appkey | string | 是 | 产品名称 |
请求json
{
"request_id": "52",
"task_id": "b4d0f8e1-5b26-4731-9107-0cdc336d6c43",
"appkey": "xxxx"
}返回说明
返回字段
与任务提交之后服务返回消息结构相同
返回json
{
"request_id": "67",
"code": 0,
"message": "",
"task_id": "b4d0f8e1-5b26-4731-9107-0cdc336d6c43",
"audio_address": "https://publish-data.obs.cn-central-221.ovaijisuan.com/tts/b4d0f8e1-5b26-4731-9107-0cdc336d6c43.wav",
"task_status": "complete"
}