pygtrans入门指南 - 支持APIKEY的谷歌翻译Python库

pygtrans简介

pygtrans是一个基于谷歌翻译API的Python翻译库,由GitHub用户foyoux开发。它具有以下主要特点:

• 支持使用APIKEY进行翻译
• 可以批量翻译大量文本,一次性翻译十万条
• 支持自动检测语言
• 支持文本和HTML翻译
• 提供TTS(文本转语音)功能

pygtrans目前在GitHub上有超过200颗星,是一个非常实用的翻译工具。

安装

使用pip安装pygtrans:

pip install -U pygtrans

或者从GitHub安装最新版:

pip install git+https://github.com/foyoux/pygtrans.git

基本用法

以下是pygtrans的一些基本用法示例:

from pygtrans import Translate

client = Translate()

# 检测语言
text = client.detect('Answer the question.')
assert text.language == 'en'

# 翻译句子
text = client.translate('Look at these pictures and answer the questions.')
assert text.translatedText == '看这些图片，回答问题。'

# 批量翻译
texts = client.translate([
    'Good morning. What can I do for you?',
    'Read aloud and underline the sentences about booking a flight.',
    'May I have your name and telephone number?'
])
assert [text.translatedText for text in texts] == [
    '早上好。我能为你做什么？',
    '大声朗读并在有关预订航班的句子下划线。',
    '可以给我你的名字和电话号码吗？'
]

# 翻译到其他语言
text = client.translate('请多多指教', target='ja')
assert text.translatedText == 'お知らせ下さい'

# 文本转语音
tts = client.tts('やめて', target='ja')
open('やめて.mp3', 'wb').write(tts)

最佳实践

1. pygtrans包含两个翻译模块:

   • Translate: 免费使用,支持批量,但需要翻墙
   • ApiKeyTranslate: 需要谷歌翻译API KEY

2. 使用Translate时的建议:

   • 使用代理: Translate(proxies={"https": "http://localhost:10809"})
   • 尽量一次性多翻译,减少请求次数,如一次翻译2000-10000条

3. 获取API KEY可以参考谷歌提供的免费试用

更多资源

• GitHub项目主页
• 完整文档
• 语言支持列表

pygtrans是一个功能强大且易用的翻译工具,无论是个人还是企业用户都可以从中受益。希望这篇入门指南能帮助你快速上手使用pygtrans,充分发挥它的翻译能力!