语音合成
一、接口描述
1. 功能描述
此接口适用于http协议调用语音合成接口,即TTS-HTTP接口。本接口暂时仅提供给京东使用。
2. 接口使用
使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址
https://aiapi.jd.com/LINGBAN_AIaaS/TTS_HTTP
2. 请求方式
POST
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
(2)body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
text | string | 是 | 灵伴即时,与生活对话,与未来沟通! | 待合成文本 |
speaker | string | 是 | nana | 说话人 |
volume | integer | 否 | 50 | 音量,可选值:[ 0~100],默认50 |
speed | integer | 否 | 50 | 语速,可选值:[ 0~100],默认50 |
pitch | integer | 否 | 50 | 音调,可选值:[ 0~100],默认50 |
inputType | string | 是 | text | 合成文本类型枚举,支持格式[text、ssml],默认text |
audioType | string | 否 | 1 | 枚举 audioType=1:返回是mp3格式 audioType=2:返回是8k8b的alaw格式 audioType=3:返回是8k8b的ulaw格式 audioType=4:返回是8k16b的wav格式 audioType=5:返回是16k8b的wav格式 audioType=6:返回是16k16b的wav格式 | 如果为空,则默认为mp3 |
stereoMono | string | 否 | 2 | 枚举 stereoMono=2:立体声 stereoMono=1:单声道 | 如果为空,则默认stereoMono=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)业务返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
audio | string | //NIxAATmAJZlghGlIBVb+ttuWnBAUc6TOZwoc5cPiekpE70iBYERLv5c+hY4EPxACDrhBE/DH5c... | 音频数据(Base64) |
message | string | OK | 返回信息 |
request_id | float | f0570617-bf1e-41e7-ae9f-f221ff3087c4 | 请求ID |
status | integer | 1 | 返回码, 1为请求成功,其他均为请求失败 |
2.返回示例
{
"audio":"//NIxAATmAJZlghGlIBVb+ttuWnBAUc6TOZwoc5cPiekpE70iBYERLv5c+hY4EPxACDrhBE/DH5c...",
"message":"OK",
"request_id":"f0570617-bf1e-41e7-ae9f-f221ff3087c4",
"status":1
}
四、错误码
1.系统级错误码
2.业务错误码
err_code | err_code_des |
---|---|
-1 | 合成失败 |
1001 | IP不合法 |
1002 | 账户余额不足 |
1003 | 话术不可为空 |
1004 | 说话人不合法 |
1005 | 账户未开通 |
1007 | 验证参数错误 |
2001 | 账户未开通 |
五、说话人音色
1.说明
音色是指语音合成引擎所能识别的音色清单列表,音色代号是在接口中传入的参数值,题材分类是指该音色推荐使用的场景
2.音色代号
音色代号 | 性别 | 名称 | 题材分类 |
---|---|---|---|
linger | 女 | 灵儿 | 童声 |
yaoyao | 男 | 妖妖 | 童声 |
subo | 男 | 苏博 | 新闻 |
mina | 女 | 米娜 | 新闻 |
linghui | 女 | 灵慧 | 新闻 |
julia | 女 | Julia | 新闻 |
jeff | 男 | Jeff | 新闻 |
youlan | 女 | 幽蓝 | 言情小说 |
lingmeng | 女 | 绫梦 | 言情小说 |
xiaocheng | 女 | 晓诚 | 玄幻小说 |
shanyu | 男 | 山雨 | 玄幻小说 |
shenghun | 男 | 圣魂 | 玄幻小说 |
hongmang | 男 | 鸿芒 | 玄幻小说 |
yuzhang | 男 | 御彰 | 玄幻小说 |
jianming | 女 | 剑鸣 | 玄幻小说 |
yunsong | 男 | 云颂 | 玄幻小说 |
youran | 女 | 悠然 | 玄幻小说 |
haohan | 男 | 浩翰 | 都市小说 |
yizhou | 男 | 易周 | 都市小说 |
mengjing | 女 | 梦静 | 都市小说 |
chuanqi | 男 | 传奇 | 游戏小说 |
rose | 女 | Rose | 英文小说 |
jack | 男 | Jack | 英文小说 |
yanyan | 女 | 妍妍 | 客服 |
nana | 女 | 娜娜 | 客服 |
lulu | 女 | 璐璐 | 客服 |
tiantian | 男 | 天天 | 客服 |
ningning | 男 | 宁宁 | 客服 |
xiaoyao | 女 | 逍遥 | 客服 |
wenxi | 男 | 文熙 | 客服 |
shuangshuang | 男 | 双双 | 客服 |
ruirui | 女 | 瑞睿 | 客服 |
nainai | 女 | 奈奈 | 客服 |
qiqi | 女 | 麒麒 | 客服 |
xiaoxiao | 女 | 筱筱 | 客服 |
yurou | 女 | 羽柔 | 客服 |
linglong | 女 | 玲珑 | 客服 |
qiulian | 女 | 秋莲 | 客服 |
luyao | 女 | 露瑶 | 客服 |
lingfeng | 女 | 灵凤 | 客服 |
lingyu | 男 | 凌宇 | 客服 |
bufan | 男 | 步凡 | 客服 |
xintong | 女 | 馨彤 | 客服 |
yiyi | 女 | 伊依 | 客服 |
zhentian | 男 | 振天 | 客服 |
xiaocheng | 女 | 晓诚 | 客服 |
chenchen | 女 | 晨晨 | 客服 |
zhengcheng | 男 | 征程 | 客服 |
siqi | 女 | 思绮 | 客服 |
chenyu | 女 | 晨雨 | 客服 |
zili | 男 | 子黎 | 客服 |
wenhui | 女 | 文慧 | 客服 |
xiaofang | 女 | 小芳 | 客服 |
xiaoai | 女 | 小艾 | 客服 |