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
"//ai-global.ctapi.daliqc.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.daliqc.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)