1、接口描述

语音合成（Text To Speech，TTS）将文本转成拟人化的语音。目前仅支持中文语音合成，提供三种音色的选择（包含一个男声，两个女声），支持自定义语调、语速等参数，支持SSML标记语言功能。

2、请求方法

POST

3、接口要求

• 目前仅支持 base64 编码方式请求

• 一次请求仅支持一条数据

4、URI

/v1/aiop/api/2z0yhhrzgv0g/tts/predict

5、请求参数

请求头header参数

请求体body参数

TextData支持SSML语言输入：

使用SSML标记语言的文本中不要再使用‘<>’，否则会出现格式解析错误。

6、请求代码示例

Curl -X POST
"https://ai-global.ctapi.ctyun.cn/v1/aiop/api/2z0yhhrzgv0g/tts/predict"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"Action": "TTS", "TextData": "今晚去吃火锅吗", "VoiceType":"2"}'

7、返回值说明

请求成功返回响应参数

表returnObj

请求失败返回响应参数

8、返回值示例

请求成功返回值示例

{
    "statusCode": 0,
    "message": "success",
    "returnObj": {
        "Audio": "_9j_4AAQSkZJRgA......Zuv_9k="
    }
}

请求失败返回值示例

{
    "statusCode": 400003,
    "message": "Body 内容为空", 
    "details": "Body 请求数据为空，没有包含内容",
    "error":"AI_OP_400003"
}

9、状态码

10、错误码说明

6 位错误码。4 开头为业务错误码，5 开头为服务错误码。

base64 解码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64decode() 函数进行编码

• java 中推荐使用 BASE64.getUrlDecoder().encodeToString() 函数进行编码

• 语音合成服务调用收到的base64编码转为wav格式音频python示例：

import json
import base64

if __name__ == "__main__":
  
    filename  = "result.json" # 调用后的 json 结果
    with open(filename, 'r') as file:
        data = json.load(file)
  
    audio_base64 = data["result"]["Audio"] # 获取返回结果中的 base64
  
    audio_wav = base64.urlsafe_b64decode(audio_base64) # 解码
  
    with open("output.wav", "wb") as f: # 保存音频为 wav 格式
        f.write(audio_wav)