Edge-TTS 文本转语音教程从安装到命令行出音 3 分钟跑通【免费下载链接】edge-ttsUse Microsoft Edges online text-to-speech service from Python WITHOUT needing Microsoft Edge or Windows or an API key项目地址: https://gitcode.com/GitHub_Trending/ed/edge-ttsEdge-TTS 让你在 Python 里直接调用 Microsoft Edge 的在线文本转语音服务不需要装浏览器、不需要 Windows、不需要 API 密钥。一条 pip 命令就能拿到 edge-tts 和 edge-playback 两个命令把文字变成 MP3、同步生成 SRT 字幕、挑选多语言音色。想给文档配朗读、想批量生成配音样本、想调节语速音调这篇指南都让你能直接上手。它是什么不装浏览器、不用 Windows、不要密钥Edge-TTS 是一个薄封装它模仿 Edge 浏览器内置朗读功能发出的网络请求直接调用背后的 TTS 服务通过 WebSocket 流式接收音频。相比本地 TTS 引擎它不用下载模型、不用等加载相比云语音 API它不注册账号、不计费、不填密钥。默认音色是 en-US-EmmaMultilingualNeural产出为 48kbps 单声道 MP3。代价只有一个全程依赖网络连接。快速上手一条命令出声音 这一节能帮你在两分钟内验证环境是否跑通。pip install edge-tts如果你不写 Python、只用命令行用pipx install edge-tts隔离安装更干净。装完执行最短示例edge-tts --text Hello, world! \ --write-media hello.mp3 \ --write-subtitles hello.srt运行成功后当前目录多出一个 hello.mp3以及逐词标记了发声时间的 hello.srt。想直接听跑edge-playback --text Hello, world!即可。场景化用法把一段文字变成能用的音频 把文件里的文字存成 MP3 加字幕目标整篇文稿进音频内容不用在命令行里用 --text 硬传。 命令edge-tts --file notes.txt --write-media notes.mp3 --write-subtitles notes.srt。 产出一个音频文件加一份可被播放器识别的 SRT字幕对齐音频的逐词边界事件长文本场景基本都这么用。列出多语言音色并试听挑选目标为某门语言找到合用的音色。 命令先跑edge-tts --list-voices输出是名称、性别、适用场景、性格四列的表格。音色名形如 ar-EG-SalmaNeural前缀就是语言和地区直接按前缀过滤。选中后加 --voice 生成edge-tts --voice ar-EG-SalmaNeural --text مرحبا كيف حالك؟ --write-media arabic.mp3。 产出目标语言朗读的 MP3不满意就换个音色再来一遍。批量生成音色样本做对比目标固定一句台词试不同音色或不同语速用耳朵挑。 命令循环里只换 --voice或者用--rate-50%半速、--volume-50%半音量、--pitch-50Hz降调调参。用 Python 更省事edge_tts.Communicate(文本, voice).save_sync(out.mp3)两行就能包进循环examples/ 目录里有现成脚本涵盖异步生成和动态选音色。 产出一组对比样本挑中哪个直接用哪个。环境表现不同网速下转换要等多久 ⚡音频是流式拉回来的网速和稳定性直接决定体验。这一节能帮你提前预判自己的条件属于哪一档。环境条件实际会发生什么网速快几十 Mbps 以上短文本几秒内完成MP3 边生成边落盘网速慢几 Mbps第一块音频到达明显变晚长文本总时长成倍拉长文本几百字以上总耗时随长度近似线性上涨拆成短段落各自更稳网络频繁断流中途可能断连输出不完整用 --proxy 指定代理可缓解两条实用结论长文本保持文件形式用 --file 传入、按段落拆分再转换直连连不上时--proxy对音色列表和语音合成都生效。踩坑速查5 个最常见的问题 ✅--rate -50%报未知选项 → 负号被当成参数 → 写成--rate-50%。终端刷出一串乱码 → 音频默认写标准输出 → 加--write-media落文件。edge-playback无声音 → 缺 mpv 播放器 → 先装 mpvWindows 除外。反复连接失败 → 在线服务必须联网 →--proxy指定代理或检查网络。自定义 SSML 无效 → 服务只认 Edge 自身生成的参数 → 改用内置--rate等选项。命令行能覆盖大部分日常需求要批量处理或嵌进自己的程序时直接用 Python 接口核心逻辑都在 src/edge_tts/ 里。延伸资源src/edge_playback/edge-playback 播放实现的源码tests/001-long-text.sh现成的长文本转换测试脚本照它改就能压测社区里也有项目用它的 Python 接口做智能家居播报和播客配音写法可直接参考 examples/ 里的模式【免费下载链接】edge-ttsUse Microsoft Edges online text-to-speech service from Python WITHOUT needing Microsoft Edge or Windows or an API key项目地址: https://gitcode.com/GitHub_Trending/ed/edge-tts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考