Gemini API 价格页更新:搜索接地每月共享 5,000 次免费查询,4K 图片约 0.113 美元
Google 更新了 Gemini API 官方价格页面中的部分计费说明,重点涉及两类费用:模型调用时触发的“依托 Google 搜索进行接地”搜索查询,以及图片生成模型的输出价格。
Gemini API 是 Google 面向开发者提供的模型调用接口,可用于把文本、图片、音频、视频、文档处理、实时语音和智能体能力接入应用。本文关注的搜索接地,适合需要实时网络信息的问答和智能体;图片输出价格,则直接影响使用 Gemini 图片模型生成不同分辨率图像的成本。
需要注意的是,价格监控发现的是官方页面中的相关文本发生变化。根据当前页面材料,搜索查询的免费额度和超额单价仍应按页面当前表述理解,现有信息并不足以证明所有 Gemini API 模型的价格都发生了统一调整。
搜索接地是什么:模型调用 Google 搜索获取网络信息
“依托 Google 搜索进行接地”(Grounding with Google Search)是指模型在生成回答时检索网络内容,以便回答需要实时信息的问题。这里的“接地”可以理解为让模型参考外部可检索资料,而不是只依据训练数据和用户在请求中提供的内容。
它与普通的 API 请求不是同一个计费单位。一次提交给 Gemini 的请求,可能触发一次或多次 Google 搜索查询;因此,API 请求数、模型调用数和搜索查询数不能简单地画等号。搜索查询还会与模型本身产生的输入、输出 token 费用分开计算。
Gemini 3 及更新模型共享每月 5,000 次免费搜索查询
价格页当前给出的规则是:每月 5,000 次搜索查询免费,额度由所有 Gemini 3 及更新模型共享;超过这一额度后,价格为14 美元/1,000 次搜索查询。
“共享”意味着这不是每个模型各自拥有 5,000 次免费额度。例如,应用同时使用多个符合范围的 Gemini 3 及更新模型时,应将这些模型产生的搜索查询合并统计,而不能为每个模型分别扣除一份免费额度。
官方说明还指出,客户提交给 Gemini 的请求可能触发一次或多次 Google 搜索,每执行一次搜索查询都会产生相应的搜索计费。对于动态检索,只有当响应中至少包含一个来自网络的接地支持网址时,该请求才会产生“依托 Google 搜索进行接地”的费用。实际核算时,应以搜索查询数量和响应中的接地信息为准,而不是只统计 API 请求数量。
如何估算搜索费用
可以先统计一个计费周期内实际产生的搜索查询总数,再扣除共享的 5,000 次免费额度。超出部分按每 1,000 次 14 美元换算。例如,应用一个月产生的搜索查询数量为 N,则超出免费额度的部分可按以下方式估算:
超额搜索查询 = max(0, N - 5000)
搜索费用 ≈ 超额搜索查询 ÷ 1000 × 14 美元
这只是搜索工具费用的估算,不包括模型输入 token、输出 token,以及其他工具可能产生的费用。若一次用户请求平均触发多次搜索,应用的用户请求量也不能直接代替搜索查询量。
4K 图片价格:0.113 美元对应 Nano Banana 2.1
价格页面还列出了 Gemini 图片模型按输出 token 和分辨率折算后的单张图片价格。每张 4K 图片约 0.113 美元这一数字,对应的是 Gemini Nano Banana 2.1,页面将其描述为 Nano Banana 2(Gemini 3.1 Flash Image)的更新版本。
在该模型的标准价格下,图片输出按每 100 万个 token 30 美元计费。不同分辨率会消耗不同数量的输出 token:
- 1K(1024×1024 像素):1,120 个 token,约 0.0336 美元/张;
- 2K(2048×2048 像素):1,680 个 token,约 0.0504 美元/张;
- 4K(4096×4096 像素):3,780 个 token,约 0.113 美元/张。
这里的 token 是模型计量输入或输出内容用量的单位。对图片模型而言,输出图片也会折算成一定数量的 token,因此分辨率越高,单张图片消耗的输出 token 通常越多。页面同时列出该模型批处理图片输出的价格为每 100 万个 token 15 美元,但是否适合使用批处理,取决于应用是否接受非实时处理方式。
不同图片模型的 4K 价格不能混用
0.113 美元并不是 Gemini API 所有图片生成功能的统一价格。比如,Gemini 3.1 Flash Image(Nano Banana 2)的图片输出标准价格为每 100 万个 token 60 美元,其 4K 输出消耗 2,520 个 token,页面折算为约 0.151 美元/张。
两者的名称相近,但模型、输出 token 费率和单张图片的 token 消耗都不同。因此,在估算图片生成成本时,至少要同时确认以下三项:
- 实际调用的模型名称,而不是只看“Gemini 图片模型”这一类称呼;
- 输出分辨率,例如 1K、2K 或 4K;
- 请求使用的是标准处理还是批处理价格。
同样,图片输出价格也不能直接套用到图片输入、文本输入或视频处理。不同模态的 token 计费规则可能不同。例如,价格页说明 PDF 等 DOCUMENT 模态的 token 按图片 token 费率计费,并会在 API 响应的 promptTokensDetails 中归入 DOCUMENT 模态。
搜索费用和图片费用之外,还要计算模型本身的用量
一次启用搜索接地的请求,可能同时包含三类成本:模型处理输入所产生的输入 token 费用、模型生成答案所产生的输出 token 费用,以及调用 Google 搜索工具产生的搜索查询费用。若请求还使用了其他工具,还需要按照对应工具自身的费率计算。
官方页面明确表示,各类工具按自身费率计费,相关费用会计入调用该工具的模型费用中;智能体的使用费则根据底层 token 消耗量和工具使用情况计算。因此,不能只拿“14 美元/1,000 次搜索”去估算一个搜索增强应用的全部 API 成本。
对于视频理解,页面还特别说明,智能体视频理解的 token 用量取决于模型实际加载的内容,而不是简单按照完整视频时长计算。官方称,这通常可以让长视频的输入 token 数量最多减少 88%,但实际数量仍取决于查询复杂程度和动态抽样深度,不能将 88% 当成固定折扣。
免费层、付费层和企业能力有什么区别
Gemini API 价格页将开发者使用方式大致分为免费层级、付费层级和企业级能力。它们不只是价格高低不同,也对应不同的访问权限、速率限制和生产能力。
- 免费层级:适合刚开始使用 Gemini API 的开发者和小型项目,提供免费输入和输出 token,以及 Google AI Studio 访问权限,但特定模型的访问权限有限。该层级的内容可能用于改进 Google 产品。
- 付费层级:面向需要更高调用量和高级功能的生产级应用,提供更宽松的生产部署速率限制、上下文缓存、Batch API,以及对 Google 先进模型的访问。页面说明 Batch API 的成本可降低 50%;这不等于搜索查询或所有工具费用都会自动按同样比例降低。
- 企业级能力:由 Gemini Enterprise Agent Platform 提供支持,在付费层级功能之外,可选专属支持渠道、高级安全与合规功能、预配吞吐量、基于用量的阶梯折扣,以及 MLOps、Model Garden 等能力。
Google AI Studio 在所有可用区域均可免费使用,但这不应与 API 生产调用的计费规则混为一谈。AI Studio 更适合试用和验证模型;应用进入生产环境后,仍需根据模型、工具、token 用量和所处计费层级核算成本。
接入前应记录哪些数据
如果应用会同时使用搜索接地和图片生成,建议在自身调用日志中分别记录模型名称、输入和输出 token、实际触发的搜索查询数量、是否返回接地支持网址、图片分辨率,以及请求是否使用批处理。这样才能将搜索工具费用、模型 token 费用和图片输出费用分开核算。
最终价格还可能因具体模型、工具、区域和计费平台而不同。官方价格页提醒,页面列出的价格可能与 Gemini Enterprise Agent Platform 上提供的价格不同,速率限制也可能随时调整。因此,本文中的 5,000 次、14 美元/1,000 次以及图片单价,应理解为当前官方价格页所列的对应规则,而不是所有 Gemini API 调用的固定统一费率。