Edge-TTS 终极指南:一行命令,让你的代码开口说话
2026年了你还在为语音合成付费这款完全免费、开源、零门槛的工具正在让商业TTS服务瑟瑟发抖。一、Edge-TTS 到底是什么简单来说Edge-TTS 是一个基于微软 Azure Cognitive Services 的开源文本转语音工具它直接调用微软 Edge 浏览器内置的在线语音引擎却不需要你安装 Edge、不需要 Windows 系统、更不需要申请任何 API 密钥。特性Edge-TTS商业 TTS如 Google TTS费用✅ 完全免费❌ 按量付费API 密钥❌ 不需要✅ 必须申请系统要求跨平台Win/Mac/Linux跨平台语言支持40 种语言300 种声音200 种语言语音质量★★★★☆★★★★★延迟~200ms~150ms一句话总结免费工具中的天花板性价比之王。二、安装一行命令5秒搞定打开终端执行pipinstalledge-tts如果你只需要命令行工具强烈推荐用pipx隔离安装pipxinstalledge-tts 国内用户如果遇到下载慢可以加清华镜像源pip install -i https://pypi.tuna.tsinghua.edu.cn/simple edge-tts验证安装成功edge-tts--version三、快速上手三步生成你的第一段语音 第一步最简命令秒出音频edge-tts--textHello, world!--write-media hello.mp3运行完毕当前目录就会多出一个hello.mp3—— 就这么简单。 第二步指定中文语音效果惊艳edge-tts--voicezh-CN-YunxiNeural--text大家好欢迎使用 Edge-TTS 语音合成--write-media hello_cn.mp3zh-CN-YunxiNeural是微软的云希女声听起来和真人几乎无异。 第三步生成带字幕的音频视频创作者福音edge-tts--text这是一段带字幕的语音示例--write-media output.mp3 --write-subtitles output.srtSRT 字幕文件直接丢进剪辑软件省时省力。四、语音库探索从普通话到方言应有尽有运行以下命令查看所有可用声音edge-tts --list-voices输出会包含语音名称、性别、语言/地区及风格特点。以下是一些宝藏语音语音名称语言特色zh-CN-XiaoyiNeural普通话晓晓温暖女声zh-CN-YunxiNeural普通话云希新闻播报风zh-CN-YunyangNeural普通话云扬阳光男声zh-CN-shaanxi-XiaoniNeural陕西方言小妮地道陕西话zh-CN-liaoning-XiaobeiNeural东北话晓北东北大碴子味zh-HK-WanLungNeural粤语粤语朗读效果炸裂zh-TW-HsiaoYuNeural台湾腔小宇台湾普通话ar-EG-SalmaNeural阿拉伯语女性阿拉伯语en-GB-SoniaNeural英式英语优雅英音实战示例——用粤语读《大话西游》经典台词edge-tts--voicezh-HK-WanLungNeural\--text曾经有一份真诚的爱情放在我面前我没有珍惜。如果上天能够给我一个再来一次的机会我会对那个女孩子说三个字我爱你。\--write-media love.mp3听完你会回来感谢我的。五、高级玩法精细控制每一个参数Edge-TTS 支持通过命令行参数调整语音的语速、音量、音调让你的语音合成真正做到千人千面。参数说明示例--rate语速±百分比--rate-50%减速一半--volume音量±百分比--volume-30%降低三成--pitch音调±Hz--pitch-50Hz降低音调组合示例——慢速低语效果edge-tts--rate-40%--volume-30%--pitch-20Hz\--voicezh-CN-YunxiNeural\--text这是一段语速较慢、音量较低的神秘语音...\--write-media mysterious.mp3六、Python 集成开发者的终极武器Edge-TTS 不仅仅是命令行工具它更是一个强大的 Python 库可以无缝集成到你的项目中。 同步生成最简单importedge_tts communicateedge_tts.Communicate(你好世界,voicezh-CN-YunxiNeural)communicate.save_sync(output.mp3) 异步生成高并发推荐importasyncioimportedge_ttsasyncdefgenerate_speech():communicateedge_tts.Communicate(你好世界,voicezh-CN-XiaoyiNeural)awaitcommunicate.save(output.mp3)asyncio.run(generate_speech()) 流式传输实时场景importasyncioimportedge_ttsasyncdefstream_audio():communicateedge_tts.Communicate(你好世界,voicezh-CN-YunxiNeural)withopen(stream.mp3,wb)asf:asyncforchunkincommunicate.stream():ifchunk[type]audio:f.write(chunk[data])asyncio.run(stream_audio()) 动态选择语音按条件筛选importasynciofromedge_ttsimportVoicesManagerasyncdefselect_voice():voicesawaitVoicesManager.create()# 筛选女性、中文、普通话targetnext((vforvinvoicesifv[Gender]Femaleandv[Locale]zh-CN),None)iftarget:communicateedge_tts.Communicate(你好世界,voicetarget[Name])awaitcommunicate.save(selected.mp3)asyncio.run(select_voice()) 生成字幕视频制作神器importasynciofromedge_ttsimportCommunicatefromedge_tts.submakerimportSubMakerasyncdefgenerate_with_subs():ttsCommunicate(这是一段带字幕的语音,zh-CN-YunxiNeural)submakerSubMaker()withopen(output.mp3,wb)asf:asyncforchunkintts.stream():ifchunk[type]audio:f.write(chunk[data])elifchunk[type]WordBoundary:submaker.create_sub((chunk[offset],chunk[duration]),chunk[text])withopen(output.srt,w,encodingutf-8)asf:f.write(submaker.generate_subs())asyncio.run(generate_with_subs())七、实时播放不保存文件直接听edge-playback--text体验实时语音合成效果⚠️ Windows 系统可直接使用macOS/Linux 需先安装 mpvbrew install mpvmacOS或sudo apt install mpvUbuntu八、实战应用场景场景解决方案有声读物制作批量脚本遍历 TXT 文件自动生成 MP3️每日新闻播客定时抓取 RSS自动合成语音推送♿无障碍辅助为视障用户生成网页/文档语音导航视频配音生成 MP3 SRT 字幕直接导入剪辑软件智能客服流式传输 多角色对话实时语音响应多语言内容一键切换 40 种语言全球化零成本九、常见问题排查问题解决方案安装失败使用国内镜像源pip install -i https://pypi.tuna.tsinghua.edu.cn/simple edge-tts语音选择无效先运行edge-tts --list-voices确认语音名称429 错误请求过多实现指数退避重试或添加代理--proxy http://your_proxy:port网络连接失败Edge-TTS 依赖微软在线服务确保网络通畅必要时使用代理快捷键无效确认焦点在网页内且输入法为英文状态十、写在最后Edge-TTS 的出现标志着语音合成技术从商业服务走向了普惠工具。无需付费、无需密钥、无需特定系统——一行命令你的代码就能开口说话。无论你是独立开发者、内容创作者、教育工作者还是仅仅想给自己的项目加一段语音Edge-TTS 都是你目前能找到的最优雅的免费方案。现在就打开终端输入edge-tts--text你好世界--voicezh-CN-YunxiNeural --write-media hello.mp3然后按下播放键——你会听到未来的声音。 项目地址https://gitcode.com/GitHub_Trending/ed/edge-tts更多示例代码请查看项目examples/目录