接口说明

更新时间：2022-11-25

接口说明

语音合成

接口描述

基于该接口，开发者可以轻松的获取语音合成能力

请求说明

合成文本长度必须小于1024字节，如果本文长度较长，可以采用多次请求的方式。文本长度不可超过限制

举例，要把一段文字合成为语音文件：

public void synthesis(AipSpeech client)
{
    TtsResponse res = client.synthesis("你好百度", "zh", 1, null);
	System.out.println(res.getErrorCode());

	// 设置可选参数
	HashMap<String, Object> options = new HashMap<String, Object>();
    options.put("spd", "5");
    options.put("pit", "5");
    options.put("per", "4");
    TtsResponse res = client.synthesis("你好百度", "zh", 1, options);
    System.out.println(res.getErrorCode());
    JSONObject result = res.getResult();    //服务器返回的内容，合成成功时为null,失败时包含error_no等信息
    byte[] data = res.getData();            //生成的音频数据
}

参数	类型	描述	是否必须
tex	String	合成的文本，文本长度必须小于1024GBK字节，建议每次请求文本不超过120字节，约为60个汉字或者字母数字。请注意计费统计依据：120个GBK字节以内（含120个）记为1次计费调用；每超过120个GBK字节则多记1次计费调用。	是
cuid	String	用户唯一标识，用来区分用户，填写机器 MAC 地址或 IMEI 码，长度为60以内	否
spd	String	语速，取值0-9，默认为5中语速	否
pit	String	音调，取值0-9，默认为5中语调	否
vol	String	音量，取值0-15，默认为5中音量（取值为0时为音量最小值，并非为无声）	否
per	String	普通发音人选择：度小美=0(默认)，度小宇=1，，度逍遥（基础）=3，度丫丫=4	否
per	String	精品发音人选择：度逍遥（精品）=5003，度小鹿=5118，度博文=106，度小童=110，度小萌=111，度米朵=103，度小娇=5	否

返回样例：

返回TtsResponse类。如果合成成功,下行数据为二进制语音文件，包含在data中。如果合成出现错误，则会填充返回值到result中。

返回失败：

// 失败返回
{
	"err_no":500,
	"err_msg":"notsupport.",
	"sn":"abcdefgh",
	"idx":1
}