Goole翻译API如何调用？开发者入门对接教程

直接调用translate.googleapis.com接口适合个人轻量使用，需URL编码参数；Cloud Translation API适用于生产环境，需创建项目、启用API、生成服务账号密钥并配置环境变量后调用。

想在自己的程序里直接调用Google翻译功能，但卡在API怎么发请求、参数怎么填、返回结果怎么读这三步上。本文只讲真实可跑通的调用路径，不绕弯子，不堆概念，所有步骤基于2026年6月最新可用接口验证。

选对API：两种路径，适用场景完全不同

Google目前存在两类翻译接口：一类是面向企业用户的官方Cloud Translation API（需注册、配额、付费）；另一类是网页版背后实际使用的轻量接口（无Key、免登录、不稳定但零成本）。你必须先确认自己要哪一种。

如果你只是写个脚本批量翻译几十条商品标题、测试小工具、或做个人学习项目——【直接走 translate.googleapis.com 接口】，省掉注册、绑卡、配额审核所有环节。

如果你要嵌入生产系统、日均调用量超10万字符、需要SLA保障和错误重试机制——必须走官方Cloud Translation API，否则随时会中断。

零成本调用：直接请求 translate.googleapis.com

方法一：手拼URL快速验证（适合调试）

打开浏览器，粘贴以下链接并回车（把“测试”替换成你要翻译的中文）：

https://translate.googleapis.com/translate_a/single?client=gtx&dt=t&sl=auto&tl=en&q=%E6%B5%8B%E8%AF%95

看到页面返回一长串方括号嵌套数据，说明接口通了。其中第一个双引号里的内容就是翻译结果，比如"test"。

注意：q参数值必须【URL编码】，中文不能直接放进去，否则返回空或报错。Python用urllib.parse.quote("测试")，JavaScript用encodeURIComponent("测试")。

方法二：用curl命令行直调（适合自动化脚本）

复制粘贴执行这行命令：

curl "https://translate.googleapis.com/translate_a/single?client=gtx&dt=t&sl=auto&tl=ja&q=$(echo -n '今天天气不错' | jq -srR @uri)"

这条命令自动完成URL编码，返回日文翻译结果。依赖jq工具，Mac用brew install jq，Linux用apt install jq。

正式接入：Cloud Translation API 完整流程

第一步：创建项目并启用API

访问 Google Cloud Console → 登录账号 → 顶部项目选择器点击“新建项目” → 填写项目名（如my-translator）→ 点击“创建” → 创建完成后，在左侧菜单进入“API和服务” → “库” → 搜索“Cloud Translation API” → 点击启用。

第二步：生成服务账号密钥

左侧菜单进入“API和服务” → “凭据” → “+ 创建凭据” → 选择“服务账号密钥” → 服务账号下拉选“新建服务账号” → 名称填translator-sa → 角色选“Project” → “Owner” → 创建 → 下载生成的JSON文件，保存到本地安全位置（如./gcp-key.json）。

第三步：设置环境变量并初始化客户端

在终端执行：export GOOGLE_APPLICATION_CREDENTIALS="./gcp-key.json"（Linux/macOS）或 set GOOGLE_APPLICATION_CREDENTIALS=./gcp-key.json（Windows CMD）。

第四步：用Python发起首次翻译请求

安装SDK：pip install google-cloud-translate

新建translate.py，写入：

from google.cloud import translate_v2 as translate
client = translate.Client()
result = client.translate("你好世界", target_language="en")
print(result["translatedText"])

运行 python translate.py，输出 "Hello World" 即成功。