TTS_語音合成v2:

TTS Speeches v2

提供語音轉文字，讓您將文本藉由 REST API 轉換為合成語音，並且支援自然的的聲調與特定語言，接下來說明如何用 http request 來取得文字轉語音服務。

Host: https://tts.api.yating.tw

Step1：使用 /speeches/short

Step2：透過 base64 解碼audioContent並存成音檔

可參考 GitHub by Yating 取得 sample code，來進行串接。

送出語音合成需求

在處理完所有輸入後，一般情況下，回應時間低於 120 秒。

Request

URL: /v2/speeches/short
Method: POST

Header

Body

Input設定

Voice設定

Voice中Model設定
目前支援兩種女性聲音(雅婷、意晴)與一種男性聲音(家豪)，選擇你要的聲音並設定。

AudioConfig設定

AudioConfig 中的 Encoding 音訊編碼設定

除了聲音類型，還可以選擇音頻輸出格式。 目前支持 MP3 和 LINEAR16。

Request Body Example

{
   "input":{
      "text":"這是測試",
      "type":"text"
   },
   "voice":{
      "model":"zh_en_female_2",
      "speed":0.8,
      "pitch":1.3,
      "energy":1.0
   },
   "audioConfig":{
      "encoding":"LINEAR16",
      "sampleRate":"22K"
   }
}

Success Response Body Example

{
   "audioContent":"//NExAARqoIIAAhEuWAAAGNmBGMY4EBcxvABAXBPmPIAF3/o...",
   "audioConfig":{
      "encoding":"LINEAR16",
      "sampleRate":"22K"
   }
}

Failure Response Body Example

{
  statusCode: 400,
  message: string[],
  error: "Bad Request"
}

• [201] created， 可以在audioContent 裡取得 base64 加密後的音檔內容，解密後存入檔案內即可播放。
• [400] invalid request format: request 參數不符合規定，如輸入的聲音編碼不存在，sampleRate不支援
• [401] unauthorized: 密鑰不存在或超出限制。
• [422] pipeline error: 請查看下表（管道錯誤消息）以獲取更多詳細信息。
• [500] internal server error

Pipeline Error message

限制

• 每個key的最大同時需求處理數：3