语音生成API

请求方式及参数基本说明

语音合成接口支持 POST 和 GET两种方式, 推荐GET方式请求。
正式地址:https://voice.v6s.cc/text2audio

接口中的文本小于512个中文字或者英文数字。
语音合成只有中英文混合模式,如数字1会合成发音为中文字“一”

请求方式和参数

上传参数

参数 可需 描述
tex 必填 合成的文本,使用UTF-8编码。小于512个中文字或者英文数字。(文本在百度服务器内转换为GBK后,长度必须小于1024字节)
tok 必填 开放平台获取到的开发者access_token(见上面的“鉴权认证机制”段落)
cuid 必填 用户唯一标识,用来区分用户,计算UV值。建议填写能区分用户的机器 MAC 地址或 IMEI 码,长度为60字符以内
ctp 必填 客户端类型选择,web端填写固定值1
lan 必填 固定值zh。语言选择,目前只有中英文混合模式,填写固定值zh
spd 选填 语速,取值0-9,默认为5中语速
pit 选填 音调,取值0-9,默认为5中语调
vol 选填 音量,取值0-15,默认为5中音量
per 选填 发音人选择, 0为普通女声,1为普通男生,3为情感合成-度逍遥,4为情感合成-度丫丫,默认为普通女声

GET调用方式(推荐)

将所有的参数都填写到URL地址中,可以通过浏览器可以播放合成的语音结果。

						
  1. https://voice.v6s.cc/text2audio?tex=***&lan=zh&cuid=***&ctp=1&tok=***
  2. // 注意tex参数需要按照url参数标准使用url_encode UTF8编码,如合成文字为“你好”,url为 http://voice.v6s.cc/text2audio?tex=%e7%99%be%e5%ba%a6%e4%bd%a0%e5%a5%bd&lan=zh&cuid=***&ctp=1&tok=***

POST调用方式

将文本以及其他参数写入到body里面,利用html表单的方式将参数传递到服务端。 所有的参数都在body中。body里面的数据为:

						
  1. tex=***&lan=zh&cuid=***&ctp=1&tok=***

返回

需要根据 Content-Type的头部来确定是否服务端合成成功。

如果合成成功,正常返回为二进制语音文件,具体header信息 Content-Type: audio/mp3

如果合成出现错误,则会返回json结果,具体header信息为:Content-Type: application/json。其中sn字段主要用于DEBUG追查问题,如果出现问题,可以提供sn帮助确认问题。

错误示例:

						
  1. {"err_no":500,"err_msg":"notsupport.","sn":"abcdefgh","idx":1}

错误码解释

错误码 含义
500 不支持输入
501 输入参数不正确
502 token验证失败
503 合成后端错误