---
name: sophnet-tts
description: 当用户需要将文本转语音（TTS）时使用。支持自动识别输入中的音色；若未指定音色则先提供可选声音风格让用户选择，指定后直接生成音频并返回 24 小时有效下载链接。
---

# Sophnet TTS

## 概述

使用 `scripts/gen_tts.py` 调用 Sophnet TTS 接口，把文本转换为音频并返回下载链接。

脚本路径：`{baseDir}/scripts/gen_tts.py`

## 何时使用

- 用户要求“生成语音 / 文本转语音 / 配音”
- 用户给出一段文本希望合成音频
- 用户指定了音色，或希望先选择音色

## 声音风格（可选项）

- 清甜推销女
- 呆萌机器人
- 经典猴哥
- 毒舌心机女
- 欢脱粤语男
- 原味陕北男
- 甜美闽南女
- 娇率才女音
- 得道高僧
- 利落从容女
- 清爽利落男
- 优雅知性女
- 居家暖男
- 正经青年女
- 知性积极女
- 沉稳权威女声
- 沉稳青年男
- 精准干练女
- 博才干练男
- 沉稳播报女
- 典型播音女

## 处理流程（必须遵循）

1. 从用户输入中提取待合成文本。
2. 判断输入中是否已经明确包含上述某个声音风格名称。
3. 若**未包含音色**：
   - 先回复用户可选声音风格列表，让用户选择其一。
   - 不要立即调用脚本生成。
4. 若**已包含音色**（或用户补充了音色）：
   - 调用脚本执行语音生成。
   - 命令示例：

   ```bash
   uv run {baseDir}/scripts/gen_tts.py \
   --text "要生成的文本" \
   --voice "优雅知性女" \
   --speech-rate 1.0
   ```

5. 输出格式

   ```
   🎙️ **声音风格**： XXX
   📝 **播报内容**：XXX
   🎵 **生成音频**：<audio controls src="http:xxxx"></audio>
   ⚠️ **提示**: 本内容有AI生成，音频保存24小时，请及时下载保存！
   ```

## 失败处理

- 若脚本失败或未返回可用链接，明确告知失败原因（若可提取到）。
- 引导用户重试（可建议缩短文本或更换音色）。

## 注意事项

- `--text` 必填且不能为空。
- 优先使用用户明确指定的音色；未指定时必须先让用户选择。
