语音合成接口
一、接口描述
1. 功能描述
语音合成提供将输入文本合成为语音二进制数据流或者音频下载url的功能 支持输出wav、mp3编码格式数据 支持设置语速,语调,音量 支持设置设置精品合成音色(发音人,如林志玲,郭德纲等),男声,女声 支持设置合成音频的采样率:8000Hz、16000Hz
3. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
用户需要使用营业执照图片base64编码去做请求,使用其他图片的base64编码请求成功时也会加入计费。
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/aispeech/tts
2. 请求方式:
post
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | String | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | String | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
(2)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | String | 是 | application/json | 标准编码格式 |
(3)body请求参数
业务请求参数
名称 | 类型 | 必填 | 默认值 | 备注 |
---|---|---|---|---|
type | String | 非必须 | tts | 合成语音或者语音文件地址(tts/url) |
tts | Object | 必须 | ||
text | String | 必须 | 文本问答内容 | |
textType | String | 必须 | text | 文本类型有,text/ssml ssml的使用方式请参考:ssml使用文档 |
voiceId | String | 必须 | zhilingf | 音色id |
speed | float | 必须 | 1.0 | 声音速速,取值范围[0.8-2.0] |
volume | number | 必须 | 80 | 音量,取值范围[0-100] |
audio | Object | 必须 | ||
audioType | String | 必须 | mp3 | 音频格式(mp3/wav) |
sampleRate | Integer | 必须 | 16000 | 采样速率 |
channel | Integer | 必须 | 1 | 信道 |
sampleBytes | Integer | 必须 | 2(必须是2) | 采样比特 |
mp3Quality | String | 非必须 | false | 默认是low,只针对mp3音频有效,当前支持取值low和high |
context | Object | 必须 | 上下文 | |
recordId | String | 必须 | 请求id |
请求示例
{
"type":"url",
"tts":{
"textType":"text",
"text":"你好,小驰,你是谁",
"speed":1,
"volume":100
},
"audio":{
"audioType":"wav",
"sampleRate":16000,
"channel":1,
"sampleBytes":2
},
"context": {
"recordId": "73c04ede-2b33-4ca4-8cc2-224ae15ec84b"
}
}
(4)请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的2接口使用
三、返回说明
1.返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
status | number | 200 | 状态code,200代表请求正常,其他为错误状态 |
result | Object | 返回结果具体内容 | |
context | Object | 上下文 | |
recordId | String | 请求id | |
tts | Object | 合成结果 | |
url | String | 合成文件url连接,五分钟有效 | |
message | string | 返回信息 |
2.返回示例
{
"status": 200,
"result": {
"context": {
"recordId": "73c04ede-2b33-4ca4-8cc2-224ae15ec84b"
},
"answer": "你好,小驰,你是谁",
"tts": {
"url": "http://tts.dui.ai/runtime/v1/cache/73c04ede-2b33-4ca4-8cc2-224ae15ec84b?productId=278571725"
}
}
}
PS. TTS提供语音声音类型
音色描述 | 资源名 (voiceId) | 音色标签 | 语言 |
---|---|---|---|
甜美女神小玲 | zhilingfa | 女声,自然 | 中英混 |
温柔女声小兰 | gqlanf | 女声,自然 | 中英混 |
标准女声小浩 | lucyfa | 女声,自然 | 中英混 |
清脆女声小颖 | lzyinfa | 女声,自然 | 中英混 |
小说女声小妮 | hyanifa | 女声,自然 | 中英混 |
飘逸女声小静 | xjingf | 女声,自然 | 中英混 |
清纯女声考拉 | kaolaf | 女声,自然 | 中英混 |
清亮女声小洁 | smjief | 女声,自然 | 中英混 |
女老师风吟 | feyinf | 女声,自然 | 中英混 |
商务女声璃璃 | lili1f_shangwu | 女声,自然 | 中英混 |
女老师行者 | xizhef | 女声,自然 | 中英混 |
女学生初阳 | cyangf | 女声,自然 | 中英混 |
娱报女声璃璃 | lili1f_yubo | 女声,自然 | 中英混 |
标准女声安宁 | aningf | 女声,自然 | 中英混 |
知性女声晶晶 | jjingf | 女声,自然 | 中英混 |
标准女声蓝雨 | lanyuf | 女声,自然 | 中英混 |
电台女声璃璃 | lili1f_diantai | 女声,自然 | 中英混 |
标准女声小妖 | xiyaof | 女声,自然 | 中英混 |
清新女声小妖 | xiyaof_qingixn | 女声,自然 | 中英混 |
女声杨阿姨 | yaayif | 女声,自然 | 中英混 |
标准女声朱株儿 | zzherf | 女声,自然 | 中英混 |
鬼故事绝音 | juyinf_guigushi | 女声,自然 | 中英混 |
故事女声小静 | xjingf_gushi | 女声,自然 | 中英混 |
故事女声砖砖 | zzhuaf | 女声,自然 | 中英混 |
高冷女声零八 | linbaf_gaoleng | 女声,自然 | 中英混 |
清新女声零八 | linbaf_qingxin | 女声,自然 | 中英混 |
女老师小妖 | xiyaof_laoshi | 女声,自然 | 中英混 |
标准女声瑶瑶 | luyaof | 女声,自然 | 中英混 |
标准女声晶晶 | jjingf | 女声,自然 | 中英混 |
甜美女神小玲 | zhilingf | 女声,传统 | 中英混 |
邻家女声小妮 | hyanif | 女声,传统 | 中文 |
标准女声小浩 | lucyf | 女声,传统 | 中英混 |
标准平和小佚 | anonyf | 女声,传统 | 中英混 |
标准男声小军 | xijunma | 男声,自然 | 中英混 |
标准男声小江 | wjianm | 男声,自然 | 中英混 |
男声季老师 | jlshim | 男声,自然 | 中英混 |
标准男声考拉 | kaolam | 男声,自然 | 中英混 |
标准男声秋木 | qiumum | 男声,自然 | 中英混 |
标准男声小睿 | tzruim | 男声,自然 | 中英混 |
磁性男声俞老师 | yukaim_all | 男声,自然 | 中英混 |
沉稳幽默纲叔 | gdgm | 男声,传统 | 中英混 |
淡定风趣葛爷 | geyou | 男声,传统 | 中英混 |
标准男声小军 | xijunm | 男声,传统 | 中英混 |
风趣幽默星哥 | zxcm | 男声,传统 | 中文 |
可爱女童然然 | qianranfa | 童声,自然 | 中英混 |
可爱男童连连 | lzliafa | 童声,自然 | 中英混 |
标准男童堂堂 | boy | 童声,自然 | 中英混 |
可爱女童然然 | qianranf | 童声,传统 | 中英混 |
可爱男童连连 | lzliaf | 童声,传统 | 中英混 |
标准女童佚佚 | anonyg | 童声,传统 | 中文 |
四、错误码信息
1.系统级错误码
2.业务错误码
业务错误码(code) | message | 说明 |
---|---|---|
200 | 正常返回 | |
400 | 缺少请求参数 | 缺少必填的请求参数 |
500 | "Internal server error" | 服务器请求错误 |