1.1 简介

edge-tts是一个Python模块，允许在Python代码中使用Microsoft Edge的在线文本转语音服务，或使用提供的edge-tts或edge-playback命令实现文字转语音。

网上有很多文本转语音服务，但多为收费的，而微软此模块包是免费的使用的。本模块是用Azure Cognitive Services来实现文本到语音转换的，使用中只要调用相应的API即可实现，且支持多种语言的声音，如中文、英文等。

为了使用此文本语音转换模块库，需要先行安装该模块。

1.2 安装

以笔者为例，我是在windows10上安装的，Python为3.9.10版。打开命令行窗口输入如下命令：

pip install edge-tts

等待下载并自动安装，完成完整后命令行窗口类似如下所示：

C:\Users\Administrator>pip install edge-tts
Collecting edge-tts
Downloading edge_tts-6.1.3-py3-none-any.whl (26 kB)
Collecting aiohttp>=3.8.0
Downloading aiohttp-3.8.4-cp39-cp39-win_amd64.whl (323 kB)
---------------------------------------- 323.6/323.6 kB 35.1 kB/s eta 0:00:00
Collecting yarl<2.0,>=1.0
Downloading yarl-1.8.2-cp39-cp39-win_amd64.whl (56 kB)
---------------------------------------- 56.8/56.8 kB 33.5 kB/s eta 0:00:00
Requirement already satisfied: charset-normalizer<4.0,>=2.0 in d:\program files\python39\lib\site-packages (from aiohttp>=3.8.0->edge-tts) (2.1.1)
Collecting async-timeout<5.0,>=4.0.0a3
Downloading async_timeout-4.0.2-py3-none-any.whl (5.8 kB)
Collecting multidict<7.0,>=4.5
Downloading multidict-6.0.4-cp39-cp39-win_amd64.whl (28 kB)
Collecting aiosignal>=1.1.2
Downloading aiosignal-1.3.1-py3-none-any.whl (7.6 kB)
Collecting attrs>=17.3.0
Downloading attrs-22.2.0-py3-none-any.whl (60 kB)
---------------------------------------- 60.0/60.0 kB 27.9 kB/s eta 0:00:00
Collecting frozenlist>=1.1.1
Downloading frozenlist-1.3.3-cp39-cp39-win_amd64.whl (34 kB)
Requirement already satisfied: idna>=2.0 in d:\program files\python39\lib\site-packages (from yarl<2.0,>=1.0->aiohttp>=3.8.0->edge-tts) (3.4)
Installing collected packages: multidict, frozenlist, attrs, async-timeout, yarl, aiosignal, aiohttp, edge-tts
Successfully installed aiohttp-3.8.4 aiosignal-1.3.1 async-timeout-4.0.2 attrs-22.2.0 edge-tts-6.1.3 frozenlist-1.3.3 multidict-6.0.4 yarl-1.8.2

[notice] A new release of pip available: 22.3.1 -> 23.0.1
[notice] To update, run: python.exe -m pip install --upgrade pip

提示：如果你只想使用edge-tts和edge-playback命令，最好使用pipx安装:

pipx install edge-tts

edge-playback只是对edge-tts的包装，用于播放生成的语音。它的参数与edge-tts选项相同。

安装完毕后，输入如下命令查看基本用法：

usage: edge-tts [-h] [-t TEXT] [-f FILE] [-v VOICE] [-l] [--rate RATE] [--volume VOLUME] [-O OVERLAPPING]
[--write-media WRITE_MEDIA] [--write-subtitles WRITE_SUBTITLES] [--proxy PROXY]
edge-tts: error: one of the arguments -t/--text -f/--file -l/--list-voices is required

1.3 示例

使用edge-tts命令实现文本转语音：

edge-tts --text "Every people of china should read and fight for China Great!" --write-media china.mp3

解释参考下图：

1.4 语言

该tts库支持较多语言的选择，可以输入如下命令查看所支持的语言语音：

edge-tts --list-voices

命令行下输入上述命令回车，输出的内如如下：

C:\Users\Administrator>edge-tts --list-voices
Name: af-ZA-AdriNeural
Gender: Female

Name: af-ZA-WillemNeural
Gender: Male
……
Name: zh-CN-XiaoxiaoNeural
Gender: Female

Name: zh-CN-XiaoyiNeural
Gender: Female

Name: zh-CN-YunjianNeural
Gender: Male

Name: zh-CN-YunxiNeural
Gender: Male

Name: zh-CN-YunxiaNeural
Gender: Male
……

Name: zh-HK-HiuGaaiNeural
Gender: Female

Name: zh-HK-HiuMaanNeural
Gender: Female

Name: zh-HK-WanLungNeural
Gender: Male

Name: zh-TW-HsiaoChenNeural
Gender: Female

……

此时若要把中文转成对应的语言按照如下形式即可：

C:\Users\Administrator>edge-tts --voice zh-CN-YunxiNeural --text "每个炎黄子孙，都应为华夏伟大复兴而奋斗！" --write-media "c:\\china-dream.mp3"

另外，edge-tts还支持调整语速与音量，只需要转换命令中添加rate与volume指令即可。示例如下：

C:\Users\Administrator>edge-tts --rate=-50% --text "Hello, world!" --write-media hello_with_rate_halved.mp3
C:\Users\Administrator>edge-tts --volume=-50% --text "Hello, world!" --write-media hello_with_volume_halved.mp3

1.5 参考

Edge-tts在Python官方项目上的连接：

edge-tts · PyPI：https://pypi.org/project/edge-tts/

相关参考示例可以在github上查看：

edge-tts/examples：https://github.com/rany2/edge-tts/tree/master/examples

欢迎点赞、转发。希望对你有所帮助。