接口说明
语音合成(TTS)可以将文字信息转换为不同语种的声音信息。该能力通过HTTP API的方式提供给
开发者,相较于SDK,该方式具有轻量、跨平台、跨开发语言的特点。
使用时请求方通过HTTP协议的POST方法将文字信息一次性的发送到服务器,然后通过HTTP协议
的GET方法去服务器获取合成结果。与一次性交互的方式(既将文字信息一次性发送到服务器,然后等
服务器处理完成之后该请求才携带合成结果返回)相比,发送文字的请求会在服务器收到文字之后就返
回,不会阻塞到服务器合成完成,减少调用等待的时间,应用处理起来更灵活。
接口要求
接口签名
为了防止通信过程中发送的消息被他人窃取和修改,每一个HTTP协议接口都需要进行签名验证,
服务器发现请求的签名不一致时会拒绝处理。
将app_key(由北京大牛儿科技发展有限公司统一分配)、请求时间(GMT格式)、base64编码
后的业务参数按照固定的顺序组成的字符串MD5后的结果作为签名,放到请求报文的Header的B-
CheckSum参数中。
接口调用模式
根据合成结果获取的方式不同,分为两种调用模式:
1. 连续调用HTTP的GET方法获取合成结果,适用于直接在终端客户的设备上发起请求时。
2. 将合成结果推送到请求时指定的HTTP 地址上,适用于在对接方公司服务器上发起请求时(终端客
户与对接方公司服务器通信,对接方服务器调用本请求)。
连续调用HTTP的GET方法获取合成结果
1. 通过HTTP协议POST方法,将文本数据一次性的发送到服务器。
2. 通过HTTP协议GET方法,去服务器获取合成结果以及是否获取结束的状态;
3. 如果HTTP协议GET方法的响应中是否获取结束的状态为未结束,需要继续调用HTTP协议GET方法
请求合成结果;为了避免频繁的交互浪费CPU和网络资源,两次HTTP协议GET方法的请求之间可以
间隔一段时间(具体值可以根据使用场景进行测试确定,建议150~200毫秒)。
将合成结果推送到请求时指定的HTTP 地址上
1. 通过HTTP协议POST方法,将文字数据一次性的发送到服务器,发送数据时携带结果推送的地址。
2. 服务器通过HTTP协议的POST方法,分多次将合成的结果推送到请求时指定的地址。
接口参数