接口说明

例：我对接的TTS接口地址是http://down.ddrj.com:9989/tts。需要语音合成的内容是我是顶顶通的工作人员。

那么机器人引擎程序根据配置自动生成接口并请求该接口，返回wav数据，mod_cti会拿到返回的wav文件并进行播放。

接口示例(可以通过浏览器直接访问)：

http://down.ddrj.com:9989/tts?config=&voice=&volume=0&speechrate=0&pitchrate=0&engine=&text=%E6%88%91%E6%98%AF%E9%A1%B6%E9%A1%B6%E9%80%9A%E7%9A%84%E5%B7%A5%E4%BD%9C%E4%BA%BA%E5%91%98

接口参数说明：

• voice：发音人。
• volume：TTS音量，0-100之间，0默认，100最大。
• speechrate：TTS语速，0-100之间，0默认，100最大。
• pitchrate：TTS语调，0-100之间，0默认，100最大。
• engine：引擎。
• text：语音合成的内容，在请求时，会使用utf8字符编码，然后进行url编码。

​

用户可以根据以上接口说明自己对接自定义TTS接口，直接实现TTS服务。

接口请求的http头

accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7
accept-encoding: gzip, deflate
accept-language: zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6
connection: keep-alive
host: down.ddrj.com:9989
upgrade-insecure-requests: 1
user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0

接口响应的http头

从响应http头的Content-Type可以看出，接口返回的格式是wav格式的音频数据。

HTTP/1.1 200 ok
Date: Wed, 09 Oct 2024 11:05:51 GMT
Server: www.ddrj.com
Content-Length: 34658
Connection: close
Content-Type: audio/x-wave
Cache-control: max-age=2147483647

接口用法

接口在话术中的用法：

• json话术：如果话术是由robotflow话术编辑器编辑出来的，那么TTS接口地址和TTS参数在话术编辑器的全局配置中设置。

  

• http话术：

  • action: cti_play_and_detect_speech：执行的动作，放音同时执行语音识别。
  • tts：TTS的配置，包括TTS接口地址和TTS参数。
    • ttsurl：配置TTS接口地址，用户可以对接自己的tts接口地址，例如：http://tts服务IP/tts。
    • ttsvoicename、ttsconfig、ttsengine、ttsvolume、ttsspeechrate、ttspitchrate：TTS参数，分别对应接口中voice(发音人)、config(TTS配置)、engine(引擎)、volume(TTS音量)、speechrate(TTS语速)、pitchrate(TTS语调)等参数。