gTTS

gTTS（Google Text-to-Speech），是一个用于与 Google 翻译文本转语音 API 交互的 Python 库和命令行工具。 可以将语音 mp3 数据写入文件、文件类对象（字节串）以供进一步音频处理，或直接输出到 stdout。 https://gtts.readthedocs.io/

功能特性

• 可自定义的、针对语音特性的句子分隔器，允许读取任意长度的文本，同时保持正确的语调、缩写、小数等；
• 可自定义的文本预处理器，例如可以提供发音修正等功能；

安装

$ pip install gTTS

快速入门

命令行：

$ gtts-cli 'hello' --output hello.mp3

模块：

>>> from gtts import gTTS
>>> tts = gTTS('hello')
>>> tts.save('hello.mp3')

更多文档和示例请参阅 https://gtts.readthedocs.io/。

免责声明

本项目 并非 与 Google 或 Google Cloud 有关联。上游变更可能会在未事先通知的情况下发生。本项目利用了未公开的 Google 翻译 语音功能，与 Google Cloud 文本转语音 不同。

项目信息

• 问题与社区
• 更新日志
• 贡献指南

许可证

MIT 许可证 (MIT) 版权所有 © 2014–2024 Pierre Nicolas Durette 及 贡献者

gTTS 快速上手指南

gTTS (Google Text-to-Speech) 是一个 Python 库和命令行工具，用于调用 Google 翻译的文本转语音 API。它可以将文本转换为 MP3 音频文件、字节流或标准输出。

环境准备

• 操作系统：Windows、macOS 或 Linux
• Python 版本：支持 Python 3.7 及以上版本
• 前置依赖：需安装 pip 包管理工具
• 网络要求：由于调用 Google 服务，请确保网络环境可访问 Google Translate（国内用户可能需要配置代理）

安装步骤

使用 pip 直接安装：

pip install gTTS

提示：国内用户若下载缓慢，可使用国内镜像源加速安装：

pip install gTTS -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

方式一：命令行使用

在终端中直接运行以下命令，将文本 "hello" 转换为音频并保存为 hello.mp3：

gtts-cli 'hello' --output hello.mp3

方式二：Python 模块调用

在 Python 脚本或交互式环境中使用：

>>> from gtts import gTTS
>>> tts = gTTS('hello')
>>> tts.save('hello.mp3')

执行后，当前目录下将生成 hello.mp3 文件，可直接播放收听。

更多高级用法（如多语言支持、语速调整、自定义分词等）请参阅官方文档：https://gtts.readthedocs.io/