---
title: Edge TTS API
emoji: 📢
colorFrom: blue
colorTo: purple
sdk: gradio
app_file: gradio_app.py
pinned: false
short_description: 基于Edge TTS的文本转语音API服务
---

# Edge TTS 配音工具

一个基于Edge TTS的文本转语音API服务，可部署在Hugging Face上。

## 功能特性

- 支持多种语音（包括中文、英文等）
- 可调整语速和音量
- 提供RESTful API接口
- 流式输出音频
- 支持多种语言和方言

## API 接口

### POST /tts

文本转语音接口

**请求体：**
```json
{
  "text": "要转换的文本",
  "voice": "语音名称（默认：zh-CN-YunxiNeural）",
  "rate": "语速调整（默认：+0%）",
  "volume": "音量调整（默认：+0%）"
}
```

**响应：**
- 音频流（MP3格式）

### GET /voices

获取所有可用语音列表

**响应：**
```json
[
  {
    "short_name": "语音名称",
    "friendly_name": "友好名称",
    "gender": "性别",
    "locale": "语言区域"
  }
]
```

## 部署到Hugging Face

### 步骤

1. **登录Hugging Face账号**
   - 访问 https://huggingface.co/ 并登录

2. **创建新的Space**
   - 点击右上角的"+"按钮，选择"New Space"
   - 输入Space名称
   - 选择Space可见性（公开或私有）

3. **配置Space设置**
   - 选择"App"类型
   - 选择"Python"作为SDK
   - 选择最新的Python版本

4. **上传文件**
   - 上传以下文件到Space：
     - `gradio_app.py` - 主应用代码
     - `requirements.txt` - 依赖列表
     - `README.md` - 项目说明文档

5. **部署**
   - 点击"Create Space"按钮
   - Hugging Face会自动安装依赖并启动应用
   - 部署完成后，访问提供的URL（格式：https://your-username-your-space-name.hf.space）

### 环境要求

- Python 3.10+
- 网络连接（Edge TTS需要访问Microsoft Edge的TTS服务）

### 部署后测试

部署完成后，可以通过以下方式测试API：

1. **访问API文档**
   - 访问 https://your-username-your-space-name.hf.space/docs
   - 使用交互式文档测试API功能

2. **测试TTS功能**
   ```bash
   curl -X POST "https://your-username-your-space-name.hf.space/tts" \
        -H "Content-Type: application/json" \
        -d '{"text": "Hello world", "voice": "en-US-JennyNeural"}' \
        -o output.mp3
   ```

### 注意事项

- 确保Space有足够的资源（Edge TTS可能需要一定的内存和CPU）
- 由于Edge TTS需要访问外部服务，部署在某些受限网络环境中可能无法正常工作
- 如果遇到网络问题，可以尝试使用VPN或检查网络防火墙设置

## 本地测试

```bash
pip install -r requirements.txt
python gradio_app.py
```

访问 http://localhost:7860 查看Gradio界面

## 可用语音示例

- 中文：zh-CN-YunxiNeural, zh-CN-YunxiaoNeural, zh-CN-YunyangNeural
- 英文：en-US-JennyNeural, en-US-GuyNeural
- 其他语言：请通过/voices接口获取完整列表

## 调整参数说明

- `voice`：语音名称
- `rate`：语速，如"+10%"（加快10%）或"-10%"（减慢10%）
- `volume`：音量，如"+10%"（增加10%）或"-10%"（减少10%）

## 许可证

MIT