google gemini api 费用

成本与用量

给用 Gemini 的开发者讲清 API 收费结构、免费额度边界与超限后的扣费顺序,附自查步骤与排查清单。

很多人接 Gemini 时是这样卡住的:测试阶段没花钱,一上量账单就冒出来,或者以为还有免费额度结果已经被计费。这篇不讲单价数字,只讲钱是怎么算的、免费额度到哪一步为止、超了之后按什么顺序扣,以及去哪核对当时的价目。

很多人接 Gemini 时是这样卡住的:测试阶段没花钱,一上量账单就冒出来;或者以为还有免费额度,结果请求已经开始计费了。这篇不讲单价数字,只讲钱是怎么算的、免费额度到哪一步为止、超了之后按什么顺序扣,以及去哪核对当时的价目。

先把一句话放前面:Gemini API 的费用跟你的调用量、模型类型、输入输出形态、账号是否绑定结算都挂钩,四者只要变一个,最终花费的口径就会变。所以下面讲的都是判断方法和自查动作,具体数额一律到站内官方 API 页面按当时展示的为准。

Gemini API 的钱到底花在哪几项

最容易被误算的是把「字数」当成唯一计费维度。Gemini 的调用通常按输入、输出两类单元分开计,多模态输入(图片、音频、视频)的折算方式和纯文本不一样,不能拿文本的字数直接套到图片或视频上。做估算时,先把一次请求拆成「送进去什么形态、拿回来什么形态」,再分别对号入座。

计费项判断要点容易踩的坑
输入单元按送进去的内容类型分别折算拿文本字数去推图片、音频的输入量
输出单元和输入分开计,长回答偏贵只看输入量估总成本,低估输出占比
多模态输入图片、音频、视频折算口径不同把一段视频按秒数当文本字数换算
缓存读取命中缓存的部分计价规则单独看以为缓存一定免费或者一定按原价

还有一点要分清:AI Studio 这类网页入口的免费试用,和开了结算账号后直接调 API,是两套规则。网页里能试的东西,不代表你的项目调用也走免费档。判断标准很简单——看你的调用是从哪个项目、哪个账号、哪个结算主体发出去的,而不是看你在哪个页面点的按钮。

免费额度到哪一步为止

免费额度很少是「只有一条上限」,通常是三件事同时约束:可用额度量、请求频率、可用模型范围。只要碰到其中任意一条,要么转成付费,要么直接返回错误。所以判断自己还在不在免费范围内,不能只看「这个月调了多少次」,得把三条线都过一遍。

  1. 确认模型范围先查你正在用的模型是否在免费档名单里,不在名单就谈不上免费用量。
  2. 确认频率上限看每分钟、每天的请求数上限是多少,压测或重试很容易先撞到这一条。
  3. 确认额度余量到站内账号或用量面板看当前消耗进度,逼近上限就提前准备切换策略。
  4. 确认数据条款免费档常有「数据可能被用于改进产品」之类的条款,涉及敏感数据就不适用。

特别提醒一句:免费和付费不是非此即彼。同一个项目里,可能一部分模型还在免费档、另一部分已经按量计费。所以确认的时候要逐模型看,而不是整站看一遍就下结论。涉及客户数据、合同约束的场景,直接走付费账号更省心。

额度用超之后钱怎么扣

超限之后的走向,取决于你的项目有没有绑定结算账号。没绑,就是请求被拒或者返回错误,不会有「偷偷扣费」这种事,最多影响可用性;绑了,才会自动转到按量计费。所以排查账单前,第一步永远是先看结算状态,而不是先怀疑计费出错。

  • 先确认项目是否已绑定结算账号:没绑就是直接报错,绑了才会自动转按量
  • 同一次请求里可能同时涉及输入、输出、缓存读取,超限那一刻的边界请求按各段实际用量分段计算
  • 设好预算告警,把风险控制在一晚之内,思路参考 /guides/budget-alert-five-gates
  • 把触发计费的模型名和调用来源记下来,后面估算和优化都要用到

关于缓存和重试还有个常见误解:命中缓存不等于这笔请求不计费,重试一次往往等于多花一次的钱。判断标准是看这一次请求实际送出了多少内容、返回了多少内容,而不是看你「本来打算只调一次」。

接之前和月底各查一遍的清单

这套检查不需要专业财务,自己就能跑。接之前做一次,跑起来之后每周花几分钟,月底再和账单对一遍,基本能把「账单突然变大」这种事故压下去。

时间点查什么去哪查
接之前目标模型在免费档还是付费档、频率上限、账号是否绑结算/official-api/providers/google
跑起来后每次调用的模型名、输入输出量、是否命中缓存/guides/usage-log-fields
月底拿用量记录反推花费,和账单核对差异/guides/cost-estimation-from-usage

对不上账的时候,排查顺序是先看计费口径、再看用量记录、最后才怀疑平台。多数差异来自多模态折算、缓存命中判定、重试次数这几处,而不是计价本身算错。

这套判断什么时候不适用

前面讲的是官方直连、以文本对话为主的常规链路。下面几种情况直接换个思路看,别把上面的单价线性外推。

  • 走第三方中转或云厂商托管时,计价口径和官方直连不同,要按那条链路的规则查
  • 批处理、长上下文、多模态混调的结构和纯文本差别大,不能按同一套方式估算
  • 免费额度规则会调整,本文只给判断方法,具体数额以站内当时的页面为准
  • 多账号、多项目并行时,按项目分别核算,别用总量倒推单个项目
下一步把当前用的模型、账号结算状态、调用日志字段先对齐一遍,再去站内价格追踪页核对当时的数字,比背旧价靠谱。

常见问题

Gemini API 是不是一直免费?

不是。免费的是特定入口或特定模型档位下的额度,有量和频率上限,且条款上通常允许平台使用你的数据。一旦绑了结算账号或用了不在免费范围的模型,就会按量计费。当前哪些模型在免费档,去 /official-api/providers/google 核对。

免费额度用完了会怎样?

取决于账号有没有绑结算:没绑会直接报错不扣费;绑了会按当时单价自动转成付费调用。想避免意外,先设预算告警并把告警阈值压到你单晚能接受的上限。额度是否恢复、多久恢复,看 /resets 里的追踪。

怎么估算自己一个月大概花多少?

先把一段时间真实调用的输入输出量记下来,再乘站内当时单价换算成单次成本,最后按预估调用次数放大。别用「一次对话多少钱」的直觉拍。具体算法可照 /guides/cost-estimation-from-usage 做一遍。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。