1. 簡介

Listnr 文本轉語音 API 是一個強大的工具，可以將文本轉換為自然流暢的語音。它集成了來自 Google、Amazon、IBM 和 Microsoft 的語音技術，提供了多種高質量的語音選項。

2. 注冊和獲取 API 密鑰

在開始使用 API 之前，您需要在 Listnr 網站上注冊并獲取一個 API 密鑰。請按照以下步驟操作：

• 訪問 Listnr 網站
• 創建一個賬戶
• 在您的賬戶設置中生成一個 API 密鑰

請確保安全地存儲您的 API 密鑰，不要在公共場合或代碼中暴露它。

3. 支持的功能

Listnr API 支持以下功能：

• 將文本轉換為語音
• 獲取文本中每個單詞的時間戳
• 通過 URL 將網頁上的文本轉換為語音
• 獲取可用的聲音列表
• 檢查作業狀態

4. API 端點概覽

以下是 API 提供的主要端點及其用途：

• /convert-text: 將文本轉換為語音（同步）
• /convert-text-async: 將文本轉換為語音（異步）
• /convert-text-with-timestamps: 將文本轉換為語音并獲取單詞時間戳
• /convert-url: 通過 URL 轉換文本為語音（同步）
• /convert-url-async: 通過 URL 轉換文本為語音（異步）
• /available-voices: 獲取可用的聲音列表
• /jobs/status?jobId=: 獲取作業狀態

5. 請求格式

所有請求都應該是 JSON 格式，并包含以下 HTTP 頭部：

• x-listnr-token: 您的 API 密鑰
• Content-Type: application/json

6. 示例用法

6.1 Python 示例

以下是一個使用 Python 將文本轉換為語音的示例：

import requests
import json

url = "https://bff.listnr.tech/api/tts/v1/convert-text"
payload = json.dumps({
    "voice": "en-US-Standard-A",
    "text": "Hello, welcome to Listnr Text-to-Speech API.",
    "audioFormat": "mp3"
})
headers = {
    "x-listnr-token": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
if response.status_code == 200:
    with open("output.mp3", "wb") as f:
        f.write(response.content)
    print("Audio file saved as output.mp3")
else:
    print("Error:", response.status_code)

7. 錯誤處理

API 可能會返回不同的 HTTP 狀態碼來表示不同的錯誤情況。請檢查響應的狀態碼，并根據需要進行相應的錯誤處理。