通过 tts.102465.xyz 实现文本转语音（TTS）

使用托管式 TTS API 将文本转换为语音音频，该 API 支持多种服务商、语音、情感模式及调优参数。

API 基础 URL

https://tts.102465.xyz

所有接口均位于 /api 路径前缀下。

快速参考

生成语音

调用 TTS 接口的两种等效方式：

POST（推荐用于较长文本或程序化调用）

curl -X POST https://tts.102465.xyz/api/tts 
  -H "Content-Type: application/json" 
  -d '{"text":"你好世界","voice":"晓晓","emotion":"温柔","provider":"azure"}' 
  --output output.mp3

GET（适用于短文本或浏览器可直接播放的链接）

https://tts.102465.xyz/api/tts?text=你好世界&voice=晓晓&provider=azure

响应为音频文件（MP3 格式）。在 curl 中使用 --output 参数保存，或直接在浏览器中打开该 GET 链接进行播放。

参数说明

各服务商概览

• azure — 默认服务商。功能最丰富：提供大量语音选项、支持情感/风格控制，以及语速与音调调节。
• volcengine — 提供替代性中文语音，包括特色语音（例如影视旁白类语音）。
• edge — 基于 Microsoft Edge 的 TTS 语音，含方言选项（如辽宁话），支持语速与音调调节。

选择语音与情感模式

生成语音前，可通过以下方式查询指定服务商支持的语音列表：

curl https://tts.102465.xyz/api/voices?provider=azure

该请求将返回一个 JSON 格式的语音列表；对于 Azure，还会附带各语音所支持的情感/风格列表。请在 voice 参数中使用语音的中文标签（如 晓晓）或英文 ID，并从该语音支持的情感列表中选取一项作为 emotion 参数值。

工作流程

1. 明确需求 — 向用户确认需转为语音的文本内容、目标语言，以及是否对语音性别、风格或情感有特定偏好。
2. 选择服务商 — 默认选用 azure；除非用户明确需要其他服务商提供的特色语音。若不确定，可调用 /api/providers 和 /api/voices?provider= 查询可用选项。
3. 生成音频 — 使用选定参数调用 /api/tts 接口。程序化调用时建议使用 POST + JSON 请求体；如需快速生成可分享链接，则构造 GET URL 即可。
4. 交付结果 — 若使用 curl/POST 方式，将 MP3 文件保存至 /mnt/user-data/outputs/ 并呈现给用户；若构造的是 GET 链接，则直接向用户提供该 URL，使其可在浏览器中播放。

GET 请求示例链接

Azure（带情感）：

https://tts.102465.xyz/api/tts?text=今天天气真不错&provider=azure&voice=晓晓&emotion=温柔

Volcengine（特色语音）：

https://tts.102465.xyz/api/tts?text=在遥远的东方，有一个古老的传说&provider=volcengine&voice=影视男解说%20中英混

Edge（方言语音）：

https://tts.102465.xyz/api/tts?text=今天咱们唠唠嗑&provider=edge&voice=晓北%20辽宁%20女

使用提示

• 构造 GET URL 时，请对中文字符和空格进行 URL 编码（例如空格编码为 %20）。
• emotion 参数仅对 Azure 生效，其他服务商会忽略该参数。
• rate 和 pitch 参数以百分比表示：正值加快语速 / 提高音调，负值减慢语速 / 降低音调；二者均支持 Azure 和 Edge。
• 若用户未指定语音，可省略 voice 参数，系统将自动采用对应服务商的默认语音。
• 程序化生成音频文件时，请统一保存为 .mp3 格式。