Python 文本转语音:Edge TTS 库使用指南
简介
Edge TTS 是一个完全免费的 Python 模块,支持跨平台运行,无需浏览器环境或 API 密钥,直接使用微软 Edge 的语音合成服务。
安装配置
打开终端,执行以下命令即可完成安装:
pip install edge-tts
验证安装是否成功:
edge-tts --version
介绍如何使用 Python 的 edge-tts 库调用微软 Edge 在线文本转语音服务。该工具无需安装浏览器或 API 密钥,支持跨平台运行。内容包括命令行快速上手、基础语音生成、多语言支持、语速音量调节、字幕生成以及异步编程示例。通过实际应用场景展示批量内容创作和实时播放功能,并提供网络优化建议。适合需要低成本高质量语音合成功能的开发者。
Edge TTS 是一个完全免费的 Python 模块,支持跨平台运行,无需浏览器环境或 API 密钥,直接使用微软 Edge 的语音合成服务。
打开终端,执行以下命令即可完成安装:
pip install edge-tts
验证安装是否成功:
edge-tts --version
生成第一个语音文件:
edge-tts --text "欢迎使用 Edge TTS 文本转语音服务" --write-media hello.mp3
查看所有可用语音:
edge-tts --list-voices
选择中文语音生成内容:
edge-tts --voice zh-CN-XiaoxiaoNeural --text "今天是个好日子" --write-media chinese.mp3
语速控制:
edge-tts --rate=-30% --text "慢速播放示例" --write-media slow.mp3
音量调节:
edge-tts --volume=+20% --text "提高音量" --write-media loud.mp3
音调调整:
edge-tts --pitch=+10Hz --text "音调变化" --write-media pitch.mp3
生成带字幕的语音文件:
edge-tts --text "这是一个带字幕的示例" --write-media output.mp3 --write-subtitles output.vtt
批量生成语音内容:
from edge_tts import Communicate
contents = [
"第一条新闻内容",
"第二条产品介绍",
"第三条教学材料"
]
for idx, text in enumerate(contents):
comm = Communicate(text, "zh-CN-XiaoxiaoNeural")
comm.save_sync(f"content_{idx}.mp3")
使用播放工具直接体验效果:
edge-playback --text "实时播放测试,无需保存文件"
注意:非 Windows 系统需要安装 mpv 播放器支持实时播放功能。
Edge TTS 通过智能参数生成技术,自动创建必要的认证参数,建立与微软 TTS 服务的稳定连接。整个过程完全透明,用户无需关心底层实现细节。
Q: 安装失败怎么办? A: 尝试使用 pip 的国内镜像源:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple edge-tts
Q: 语音选择无效?
A: 确保语音名称拼写正确,可通过 --list-voices 查看完整列表。
异步处理提高效率:
import asyncio
from edge_tts import Communicate
async def generate_audio(text, voice):
communicate = Communicate(text, voice)
await communicate.save(f"{text[:10]}.mp3")
# 批量异步处理
texts = ["文本 1", "文本 2", "文本 3"]
tasks = [generate_audio(text, "zh-CN-XiaoxiaoNeural") for text in texts]
await asyncio.gather(*tasks)
Edge TTS 为开发者提供了前所未有的便利:

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online