edge-tts

免密钥调用微软 Edge 语音，几行代码生成自然 MP3

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署音频音乐 🍴 复刻 1180 🐛 待处理 9 👀 关注 82

GitHub ↗

GitHub 星标 ★ 12489

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费完全免费，无需API密钥，使用微软Edge在线TTS服务，需自行部署。

项目预览

项目数据

分类音频音乐

开发团队rany2

GitHubhttps://github.com/rany2/edge-tts

定价模式🏷️完全免费

价格说明完全免费，无需API密钥，使用微软Edge在线TTS服务，需自行部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型speech-synthesis,text-to-speech,tts

GitHub 星标★ 12489

上线时间2021-05-10 00:00:00

代码更新2026-10-14

仓库体积2.1 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数9

项目介绍

edge-tts 是一个 Python 库，让你无需安装 Microsoft Edge、Windows 或申请 API key，就能直接调用微软 Edge 浏览器内置的在线文本转语音（TTS）服务。它通过模拟 Edge 的 WebSocket 接口，将文本转换为自然流畅的语音音频，支持多种语言和声音（如晓晓、云希等），可输出 MP3 格式。该工具解决了开发者快速获取高质量 TTS 能力的需求，尤其适合需要免费、无需复杂认证的语音合成场景。核心能力包括：简单的 API 调用、异步支持、自定义语速/音调/音量、批量生成音频文件，以及命令行工具。项目活跃，社区维护良好，是轻量级 TTS 解决方案中的热门选择。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 12489

技术标签

speech-synthesis text-to-speech tts

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 环境（需可用 pip 安装包）
如需只用命令行工具，建议安装 pipx
使用 edge-playback 播放需额外安装 mpv 命令行播放器（Windows 除外）
可联网环境，TTS 使用微软 Edge 在线服务

安装与启动步骤

1安装 edge-tts

用 pip 安装 edge-tts，即可在 Python 代码或命令行中使用，无需 Edge 浏览器和 API key。
```
pip install edge-tts
```
2改用 pipx 安装

若只用 edge-tts 与 edge-playback 命令，README 建议用 pipx 安装，隔离环境更干净。
```
pipx install edge-tts
```
3生成首个音频

指定文本，输出 MP3 音频和 SRT 字幕两个文件，文件写在你执行命令的当前目录。
```
edge-tts --text "Hello, world!" --write-media hello.mp3 --write-subtitles hello.srt
```
4查看可用声音

列出所有可用的声音名称、性别等，方便后续用 --voice 指定想要的声音。
```
edge-tts --list-voices
```
5指定声音合成

用 --voice 传入上一步列表中看到的声音名，其余参数与默认用法一致。
```
edge-tts --voice af-ZA-AdriNeural --text "Hello, world!" --write-media hello.mp3
```
6直接播放音频

edge-playback 可即时播放并带字幕，需已安装 mpv（Windows 除外），不需要写文件。
```
edge-playback --text "Hello, world!"
```

关键配置

配置项	必填	说明	示例
`--text`	是	要转换的文本内容	`"Hello, world!"`
`--voice`	否	指定语音服务使用的声音名称	`af-ZA-AdriNeural`
`--write-media`	否	把合成的音频写入指定文件	`hello.mp3`
`--write-subtitles`	否	把字幕写入指定 SRT 文件	`hello.srt`
`--list-voices`	否	列出全部可用声音及其信息