edge-tts-api
一个基于微软 Edge TTS 的自托管 API 服务,完全免费,无需 API Key,可被飞书、钉钉等应用调用。
Highlights
- 💰 完全免费 - 使用 Edge TTS,无需 Azure 账户或 API Key
- 🎙️ 神经网络音质 - 与 Azure TTS 相同的高质量语音
- 🌏 多语言支持 - 中文、英文、日文等 40+ 语言
- ⚡ 快速响应 - RESTful API 设计
- 🔌 通用接口 - 可接入任何应用(飞书、钉钉、微信...)
- 🐳 一键部署 - Docker 支持
Triggers
- 部署 tts 服务 / tts api / 语音服务
- 飞书机器人 tts / 钉钉语音播报
- edge tts / 免费 tts / 无需 api key
- 自托管 tts / self-hosted tts
- install tts service
Quick Start
安装并启动
# 通过 npx skills add 安装
npx skills add your-username/edge-tts-api
# 进入目录
cd ~/skills/edge-tts-api
# 一键部署到云服务器
bash scripts/deploy-cloud.sh
# 或本地启动
bash scripts/start.sh
快速测试
curl -X POST http://localhost:8000/tts \
-H "Content-Type: application/json" \
-d '{"text": "你好,世界"}' \
--output hello.mp3
Capabilities
文本转语音
- 支持多种神经网络音色(中文、英文等多语言)
- 语速、音调、音量可调
- 返回 MP3 格式音频
音色选择
中文音色:
xiaoxiao- 晓晓(女声,温柔)xiaoyi- 晓伊(女声,亲和)yunyang- 云扬(男声,成熟)xiaomeng- 晓梦(童声)
英文音色:
aria- Aria(女声)guy- Guy(男声)
飞书集成
本技能提供完整的飞书集成示例,支持:
- 群聊消息转语音
- @机器人触发
- 自定义音色和语速
Workflow
- 安装技能 -
npx skills add your-username/edge-tts-api - 配置环境 - 复制
.env.example到.env(可选) - 启动服务 -
bash scripts/start.sh或部署到云服务器 - 调用 API - 通过 HTTP POST 请求生成语音
- 集成应用 - 接入飞书、钉钉等应用
API Endpoints
| 端点 | 方法 | 说明 |
|---|---|---|
/tts | POST | 文本转语音 |
/voices | GET | 获取音色列表 |
/voices/popular | GET | 获取常用音色 |
/health | GET | 健康检查 |
Requirements
- Python 3.10+
- 服务器:512MB+ 内存
- 已开放端口:8000(或自定义)
Limitations
- Edge TTS 通过逆向工程实现,未来可能有变化
- 不支持语音克隆(如需克隆可使用 Noiz TTS)
- 建议用于个人和非商业项目
Cloud Deployment
支持一键部署到:
- 腾讯云
- 火山引擎
- 阿里云
- AWS
详见 docs/CLOUD_DEPLOYMENT.md 或 docs/VOLCENGINE_DEPLOYMENT.md
Integration Examples
飞书机器人
import requests
TTS_API = "http://YOUR_SERVER_IP:8000/tts"
def send_voice_message(text):
response = requests.post(TTS_API, json={"text": text})
audio = response.content
# 发送到飞书...
cURL
curl -X POST http://localhost:8000/tts \
-H "Content-Type: application/json" \
-d '{"text":"你好","voice":"xiaoxiao"}' \
--output speech.mp3
完整示例见 examples/ 目录。
License
MIT License