Listnr AI 语音生成器

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 状态码来表示不同的错误情况。请检查响应的状态码，并根据需要进行相应的错误处理。