依据文本生成TTS语音接口
场景描述
智能助手平台提供接口给第三方接入方调用,实现文本生成TTS语音。
如果需要转换的文本内容较长时,则接口响应时间会对应的增加。
接口方法
POST
接口URI
https://IP:PORT/oifde/rest/api/tts/texttovoice
消息头
Content-Type:application/json; charset=UTF-8
请求说明
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
tenantId |
string |
True |
租户ID。 |
2 |
authToken |
string |
True |
认证token。 请参见C3 智能助手平台接口鉴权方式。 |
3 |
text |
string |
True |
待合成的文本内容,必须使用UTF-8编码。 |
4 |
config |
Object |
True |
语音合成的配置信息。 该对象的参数说明请参见表2。 |
序号 |
参数名 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
4.1 |
voiceName |
String |
True |
模型特征串,服务器端利用此值来调用不同的模型。 目前支持的有:
|
4.2 |
pitch |
String |
False |
基频,调节音调高低。 取值范围:-500~500, 缺省:0。 |
4.3 |
volume |
String |
False |
音量,调节音量大小。 取值范围:0~100,缺省:50。 |
4.4 |
speed |
String |
False |
语速,调节语速快慢。 取值范围:-500~500, 缺省:0。 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
参数名
参数类型
说明
1
retCode
String
0,成功,其他为失败。
2
retMsg
String
失败原因的描述。
3
data
object
返回结果。
该对象的参数说明请参见表4。
表4 data参数说明 序号
参数名
参数类型
说明
3.1
format
String
音频编码格式。
3.2
sampleRate
int
音频采样率。
3.3
voiceData
String
BASE64编码之后的音频数据。
3.4
sentences
List
输出的分句信息。
该对象的参数说明请参见表5。
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
请求消息头
Content-Type:application/json; charset=UTF-8
请求体消息
{ "config": { "voiceName":"cn_tianmeiru_common" }, "text":"你好,测试一下文本合成语音接口。", "authToken": "********************", "tenantId":"********************" }
响应体消息
{ "data": { "sentences": [ { "st": 0, "offset": 0, "len": 48, "et": 2790 } ], "voiceData": "UklGRuRsAQBXQVZFZm10IBA", "format": "wav", "sampleRate": "16000" }, "retCode": "0" }