---
title: Edge TTS API
emoji: 🎤
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
short_description: 基於 Microsoft Edge TTS 的文字轉語音 API 服務
---

# Edge TTS API 服務

這是一個基於 Microsoft Edge TTS 的文字轉語音網路服務，使用 FastAPI 框架構建，現在部署在 Hugging Face Spaces 上。

## 功能特色

- 🎤 支援多種語音和語言
- ⚡ 快速響應的 API 服務
- 🔧 可調整語速、音量和音調
- 📱 支援 CORS，可用於前端應用
- 📊 自動生成的 API 文檔
- 🗂️ 文件管理功能

## 快速開始

### 1. 訪問服務

- **API 服務**: 點擊右上角的 "View API" 按鈕
- **API 文檔**: `https://your-space-name.hf.space/docs`
- **健康檢查**: `https://your-space-name.hf.space/health`

### 2. 使用 API

#### 獲取語音列表
```http
GET /voices
```

#### 文字轉語音 (POST)
```http
POST /tts
Content-Type: application/json

{
    "text": "你好，世界！",
    "voice": "zh-TW-HsiaoChenNeural",
    "rate": "+0%",
    "volume": "+0%",
    "pitch": "+0Hz"
}
```

#### 文字轉語音 (GET)
```http
GET /tts?text=你好世界&voice=zh-TW-HsiaoChenNeural&rate=+0%&volume=+0%&pitch=+0Hz
```

## 使用範例

### Python 客戶端

```python
import requests

# 替換為您的 Hugging Face Space URL
base_url = "https://your-space-name.hf.space"

# 使用 POST 方法
response = requests.post(f"{base_url}/tts", json={
    "text": "你好，這是測試文字",
    "voice": "zh-TW-HsiaoChenNeural"
})

if response.json()["success"]:
    audio_url = response.json()["audio_url"]
    print(f"音頻文件：{base_url}{audio_url}")

# 使用 GET 方法
response = requests.get(f"{base_url}/tts", params={
    "text": "你好，這是測試文字",
    "voice": "zh-TW-HsiaoChenNeural"
})

# 直接下載音頻文件
with open("output.mp3", "wb") as f:
    f.write(response.content)
```

### JavaScript 客戶端

```javascript
// 替換為您的 Hugging Face Space URL
const baseUrl = "https://your-space-name.hf.space";

// 使用 POST 方法
fetch(`${baseUrl}/tts`, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        text: '你好，這是測試文字',
        voice: 'zh-TW-HsiaoChenNeural'
    })
})
.then(response => response.json())
.then(data => {
    if (data.success) {
        console.log('音頻文件：', `${baseUrl}${data.audio_url}`);
    }
});

// 使用 GET 方法
const audioUrl = `${baseUrl}/tts?text=你好世界&voice=zh-TW-HsiaoChenNeural`;
window.open(audioUrl, '_blank');
```

## 常用語音

### 🇹🇼 台灣語音
- `zh-TW-HsiaoChenNeural` - 台灣女聲 (HsiaoChen)
- `zh-TW-HsiaoYuNeural` - 台灣女聲 (HsiaoYu)
- `zh-TW-YunJheNeural` - 台灣男聲 (YunJhe)

### 🇨🇳 中國語音
- `zh-CN-XiaoxiaoNeural` - 中國女聲 (Xiaoxiao)
- `zh-CN-XiaoyiNeural` - 中國女聲 (Xiaoyi)
- `zh-CN-YunjianNeural` - 中國男聲 (Yunjian)
- `zh-CN-YunxiNeural` - 中國男聲 (Yunxi)
- `zh-CN-YunxiaNeural` - 中國男聲 (Yunxia)
- `zh-CN-YunyangNeural` - 中國男聲 (Yunyang)

### 🇺🇸 美國語音
- `en-US-JennyNeural` - 美國女聲 (Jenny)
- `en-US-GuyNeural` - 美國男聲 (Guy)

### 🇬🇧 英國語音
- `en-GB-SoniaNeural` - 英國女聲 (Sonia)
- `en-GB-RyanNeural` - 英國男聲 (Ryan)

## 參數說明

### 語速調整 (rate)
- `+50%` - 加快 50%
- `-50%` - 減慢 50%
- `+0%` - 正常速度

### 音量調整 (volume)
- `+50%` - 增加音量 50%
- `-50%` - 減少音量 50%
- `+0%` - 正常音量

### 音調調整 (pitch)
- `+50Hz` - 提高音調
- `-50Hz` - 降低音調
- `+0Hz` - 正常音調

## 注意事項

1. 生成的音頻文件會保存在臨時目錄中
2. 文件會自動生成唯一 ID，避免衝突
3. 服務需要網路連接才能使用 Microsoft Edge TTS
4. 在 Hugging Face Spaces 上，音頻文件會在短時間後自動清理

## 授權

本項目基於 MIT 授權條款開源。