文本合成接入

接口信息

接口地址

http://smartdevice.ai.turingapi.com/speech/v2/tts

请求方法

Method: POST
Content-Type: application/json

请求参数

参数	必选	类型	说明
parameters	true	json	文本合成请求参数

parameters 字段说明

参数	必选	类型	说明
ak	true	String	apiKey,用于权限验证
uid	true	String	设备ID加密后的字符串(参考AIWIFI接入)
token	true	String	请求令牌，首次请求可以为空。(参考AIWIFI接入)
text	true	String	需要合成的文本
tone	true	int	tts发音人选择 取值范围20~22
tts	true	int	需要合成的音频的格式。当tts=2时：mp3_24; 当tts=3时：mp3_16(推荐); 当tts=4时：amr_nb。 如果需要其他格式，请联系商务
tts_lan	false	int	需要合成的语种（目前支持中文和英文）。 当tts_lan=0时，中文合成（默认）；当tts_lan=1时，英文合成。
speed	false	int	tts语速设置，取值范围1~9，默认为5
pitch	false	int	tts语调设置，取值范围1~9，默认为5
volume	false	int	tts音量，取值范围1～9，默认 5

tone音色说明

值	音色说明
20	智娃，男童，情感TTS
21	阿Q，女童，情感TTS
22	慧听，成年女声，情感TTS

返回参数

参数	必传	类型	说明
code	true	int	返回码。当code=200时，合成成功。当code=4xxxx时，合成失败 , 参加code列表
token	true	String	请求令牌，开发者自己保存起来，用于下一次请求
url	true	array(数组)	返回合成音频的地址。如果文本很大，会返回多段音频，以数组的形式

示例

请求示例

{
    "parameters": {
        "ak": "8268ff3bce3e******0a6d49a0fddcd5",
        "uid": "9C5DE14C6503******21D7A41DA23B4D",
        "tone": 21,
        "text": "我的名字叫小小王",
        "token": "2af62825b9cd******c55a6256a86239",
        "tts": 3
    }   
}

返回示例

 {
    "code": 200,
    "token": "2af62825b9cd******c55a6256a86239",
    "url": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-8268ff3bce3e45c7b10a6d49a0fddcd5-9699c4175a02413aaed736dc4c655d10.mp3"
    ]
}

附表

code码对照表

错误代码	返回msg	详细描述
200	请求正确	表示文本合成成功
40001	value error	字段错误
40002	illegal value	非法字段
40003	value is null or missing	字段为空或错误
40005	tts failure	文本转语音失败
40007	token invalid value	无效token
40008	is expired	过期
40012	request is forbidden	拒绝请求
40013	out of device count limit	请求超出限制
47310	robot count day_limit_exceeded	超过了每天的请求数量
47320	robot count hour_limit_exceeded	超过了每小时的请求数量
47330	robot count minute_limit_exceeded	超过了每分钟的请求数量
49999	unknown error	未知错误
42000	synthetic tts text is null	合成tts的文本为null