✓ 已对照谷歌官方页面核实,核实日期为 2026 年九月 23 日。界面和价格会变化:如果看到的不一样,请以谷歌显示的为准。
Gemini API 密钥是一串密钥,能让 TranslateRocket 把你网站的文本发送给谷歌的 AI 模型 Gemini,并把翻译结果取回来;谷歌提供一个有限额的免费版,以及一个需要提前充值的付费版。
📖 你会遇到的词汇
- API key:一长串密钥。谁拿到它就能使用你的配额(如果你是付费用户,还能花掉你的额度),所以要像对待密码一样对待它。
- Google AI Studio:谷歌用于创建 Gemini 密钥的网站,地址是 aistudio.google.com。
- Project:谷歌用来归组你的密钥和账单的容器。AI Studio 会自动为你创建一个。
- 免费版 / 付费版:免费版 = 无需银行卡,不收费,但限额更低。付费版 = 你添加一张银行卡并预付额度。
- Token:谷歌计费的单位。对 Gemini 来说,1 个 token 约等于 4 个字符。
开始前你需要准备的东西
- 一个 Google 账户(一个 Gmail 邮箱地址即可)。
- 免费版:无需银行卡。新账户默认使用免费版。
- 付费版:需要一张银行卡,以及至少 $5的预付款(或你所在货币的等值金额)。
- 大约 5 分钟。
在选择免费版之前:两个如实的提醒
- 你的文本可能会被谷歌使用。在免费版中,谷歌可能会使用你发送的内容来改进其产品,人工审核员也可能会阅读它。谷歌的条款要求不要发送敏感、机密或个人信息。你公开的网页内容通常不是秘密,但如果你的网站有私密内容,请多加考虑。例外情况:如果你位于欧洲经济区、瑞士或英国,谷歌表示即使在免费版中,付费版的数据规则也适用于你。
- 欧洲或英国的企业:请阅读谷歌条款中的这一条。谷歌的条款规定,当你向欧洲经济区、瑞士或英国的用户提供“API Client”时,你只能使用付费服务。翻译你自己的网站是否属于这种情况,是一个我们无法替你解答的法律问题。如果不确定,请设置结算(见下方第 7 步)或咨询你的法律顾问。
另外,免费版有速率限制(每分钟和每天可发送的请求数量)。谷歌没有在其文档页面上公布固定的数字;你可以在 AI Studio 中看到自己的限额。大型网站可能需要好几天,或者需要使用付费版。
分步说明
这就是免费版所需要的全部内容。要升级到付费版(更高的限额,且你的文本不会被用于改进谷歌的产品):
有用信息:自 2026 年五月 28 日起,在 AI Studio 中创建的每个新密钥都是一种更安全的新类型(“auth key”)。谷歌表示从 2026 年九月起会拒绝较旧的“standard”密钥。如果你有一个旧的 Gemini 密钥,请创建一个新的。
费用是多少
免费版:在谷歌免费提供的模型上,只要在你的速率限制之内,就完全免费。
付费版 — 官方价格(谷歌 Gemini API 价格页面,核实于 2026 年九月 23 日),每 1M token:
| Model | 你发送的文本(输入) | 你收到的译文(输出,包括“思考”部分) |
|---|---|---|
| Gemini 2.5 Flash-Lite | $0.10 | $0.40 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 |
| Gemini 2.5 Flash | $0.30 | $2.50 |
TranslateRocket 的默认模型是 gemini-flash-lite-latest,这是谷歌指向其最新 Flash-Lite 版本的一个名称。谷歌没有在该页面上说明今天具体是哪个版本,所以请查看你在 AI Studio 中看到的 Flash-Lite 模型的价格。
这对小型网站意味着什么。我们的示例:一个20 个页面、每页约 600 字的网站(12,000 字,约 75,000 个字符),翻译成一种语言。
- 75,000 个字符大约相当于 19,000 个 token。
- TranslateRocket 在每批请求中还会发送简短的指令,而且译文往往比英文原文更长。为保险起见,我们按输入 30,000 个 token、输出 30,000 个 token计算。较新的 Gemini 模型在回答前还可能进行“思考”,谷歌会把这部分思考按输出计费,所以实际数字可能更高。
- 免费版:$0。
- 付费版,Gemini 2.5 Flash-Lite:30,000 × $0.10 / 1,000,000 + 30,000 × $0.40 / 1,000,000 ≈ $0.02。
- 付费版,Gemini 3.5 Flash-Lite:约 $0.08。
预付额度12 个月后过期,且不可退款(谷歌列出的特定情况除外)。
安全提示(请阅读)
1. 在免费版中不会被扣费。没有设置结算方式,谷歌就没有可以扣费的银行卡。
2. 在付费版中,设置一个支出上限。
- 在 AI Studio 中,打开 Spend 页面。
- 在 Monthly spend cap 下,点击 Edit spend cap。
- 输入一个月度金额,例如 $5,然后保存。
谷歌将此功能标记为实验性,并提醒支出可能会在停止前超出上限约 10 分钟。如果你开启了自动充值,也请设置一个 Monthly Limit:AI Studio 的 Billing 页面 → Manage auto-reload → 展开 Monthly Limit → 输入金额 → Save。使用预付额度并关闭自动充值后,你损失的金额永远不会超过你充值的额度。
3. 也在 TranslateRocket 内部设置一个限额。 在 TranslateRocket → AI Translation,在 Usage & limits部分,填写 Daily character limit (例如 200000)。达到限额后,AI 翻译会暂停,直到第二天。 0 表示不限制。
4. 绝不要分享密钥。谷歌表示:要像对待密码一样对待它。不要把它放进邮件、聊天记录、截图或支持工单中。
5. 如果你认为密钥已经泄露(谷歌自己的检查清单):
- 在 AI Studio 中创建一个新密钥并粘贴到 TranslateRocket 中。
- 在 Google Cloud 控制台的 Credentials 页面停用或删除旧密钥:https://console.cloud.google.com/apis/credentials(选择项目,然后选择密钥)。如果你不小心删错了密钥,30 天内可以恢复。
- 在 AI Studio(Dashboard → Usage)中检查你的使用情况,看是否有你不认识的活动。
在 TranslateRocket 中粘贴到哪里
- 在你的 WordPress 后台,打开 TranslateRocket → AI Translation。
- 在 Provider & keys 框中,找到名为 Google Gemini 的卡片。
- 把你的密钥粘贴到 API key 字段中。
- 在框的顶部,把 Active provider 设置为 Google Gemini。
- 可选:Model 字段可以留空(此时 TranslateRocket 会使用 gemini-flash-lite-latest)。Load available models 按钮会列出你的密钥可以使用的模型。
- 点击页面底部的 Save AI settings。
卡片现在会显示 Active 标记。你可以在 Translations 页面翻译,也可以在可视化编辑器中逐页翻译。
如果遇到问题
| 你看到的内容 | 通常意味着什么 | 该怎么做 |
|---|---|---|
| 关于无效密钥的错误提示,或 HTTP 400/403 | 密钥复制错误,或者它是谷歌不再接受的旧版 standard 密钥,或者它在 AI Studio 中被标记为Blocked。 | 请仔细重新粘贴。如果仍然失败,请在 AI Studio 中创建一个新密钥:新密钥是被接受的类型。 |
429 RESOURCE_EXHAUSTED |
你发送的内容太多、太快:触发了免费版的限额,或者(付费版)触发了支出速度限制。每日限额会在太平洋时间午夜重置。 | 请稍等并稍后重试,或者一次翻译更少的页面,或者升级到付费版。 |
402 Payment Required |
付费版:你的预付额度已降到 $0。与该账单账户关联的所有密钥会一起停止。 | AI Studio 的 Billing 页面 → Buy credits。 |
常见问题
Gemini API 密钥是免费的吗?
是的,有一个无需银行卡的免费版,速率限制可以在 Google AI Studio 中查看。在免费版中,谷歌可能会使用你发送的文本来改进其产品;欧洲经济区、瑞士和英国适用不同的规则。
我的旧 Gemini API 密钥不能用了,为什么?
自 2026 年五月 28 日起,在 AI Studio 中创建的新密钥是一种更安全的新类型,谷歌表示从 2026 年九月起会拒绝较旧的 “standard” 密钥。请在 AI Studio 中创建一个新密钥。
Gemini 和 Google Cloud Translation 是同一个东西吗?
不是。Gemini 是谷歌的 AI 模型,密钥来自 Google AI Studio。Google Cloud Translation 是 Google Translate 的专业版服务,密钥来自 Google Cloud 控制台,且需要开启结算。
付费版 Gemini API 的费用是多少?
付费版最低需要预付 $5。使用 Flash-Lite 模型,一个 20 页网站翻译成一种语言大约需要 $0.02 到 $0.08。
该选哪一个?
查看我们的对比页面,可以简单比较全部五种服务,也能找到完全无需密钥的免费方案。
其他指南:OpenAI · Anthropic(Claude) · DeepL · Google Cloud Translation · 该选哪一个?