语音合成接口

一、接口描述

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" 服务器请求错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""