很多人接完 Gemini API，第一反应是「我就跑了几百次，怎么账单和想象的对不上」。问题往往不在贵不贵，而在于你根本没搞清它按什么单位计、免费额度怎么抵扣、钱又该去哪一页看。这篇不讲虚的，直接给你三件事：计费单位怎么拆、免费额度的边界在哪、账单和用量分别到哪个入口核对，最后附一张排查顺序表，账单对不上时按顺序走一遍就能定位。
很多人接完 Gemini API，第一反应是「我就跑了几百次，怎么账单和想象的对不上」。问题往往不在贵不贵，而在于你根本没搞清它按什么单位计、免费额度怎么抵扣、钱又该去哪一页看。这篇不讲虚的，直接给你三件事：计费单位怎么拆、免费额度的边界在哪、账单和用量分别到哪个入口核对，最后附一张排查顺序表，账单对不上时按顺序走一遍就能定位。
先说清一件事：站内不做实时报价，所有当期数字统一到官方 API 页面核对。这篇只讲口径和动作，你照着走能把账算明白，也能知道自己在哪一步想错了。
先搞清它按什么单位收钱
计费的第一层不是单价，是单位。Gemini 的调用大致分两类账：一类按文本量算，输入和输出是两个方向；一类按多模态输入各自的单位算，比如音频按秒、图像按张。很多人对不上账，是拿一个单位套了全部调用。具体当期口径到 /official-api/providers/google 核对。
- 输入方向
- 你喂给模型的提示词、上下文、附件，单独计价
- 输出方向
- 模型生成的回答，单价通常和输入不是同一个数
- 多模态单位
- 音频按秒、图像按张或按分辨率档，跟文本不是一套账
- 计价档
- 长上下文、批量提交、缓存命中可能各走一档，以站内当期页为准
- 先确定这次调用属于哪一类单位，再谈单价，单位错了后面全错；
- 多模态输入对照 /image-video-billing-units 的思路看，别用文本 token 去估算；
- 长上下文和批量提交是否单独计档，到 /official-api 当期页确认，不要凭印象；
- 缓存命中会改变实际计费量，这条最容易造成「预估偏高」的错觉。
免费额度能抵什么、抵到哪停
免费额度不是「所有调用都免费到某个量」，它通常只覆盖部分模型和部分调用方式。付费档模型不一定走免费池，这个覆盖范围必须先到 /official-api/providers/google 确认，而不是默认以为自己的调用在免费范围里。
| 要确认的点 | 怎么确认 | 不确认的后果 |
|---|---|---|
| 覆盖哪些模型 | 站内官方 API 页当期说明 | 以为免费，实际按量扣 |
| 覆盖哪些调用方式 | 对照多模态与批量的分类口径 | 批量任务被当成免费池 |
| 额度耗尽后的行为 | 官方控制台额度页 + 站内口径 | 被拒请求或直接转按量，两种体验差很远 |
| 团队内成本分摊 | 参照 /free-quota-cost-allocation | 内部算不清谁花了多少 |
额度用尽后的行为有两种分叉：直接拒绝请求，或者转成按量计费继续扣。这个分叉必须在开跑前确认，别等收账单才发现。免费额度和付费额度混用时的成本分摊，参照 /free-quota-cost-allocation 的口径，否则多人共用一个项目时根本说不清。
账单和用量分别去哪看
这里要分清两个东西：官方控制台里的用量与计费明细是真实账单，站内页面做的是口径解释和横向比价。想看当期数字，统一到 /official-api 核对，别拿站内估算值当账单值。
- 看真实用量进官方控制台的用量页，导出本周期记录，确认字段完整。
- 过一遍估算把同一段提示词丢进 /tools/model-cost-calculator，得到估算值，和账单值分开记。
- 对齐字段导出记录的字段按 /usage-log-fields 的清单对齐，缺字段月底就对不上。
- 排查差异账单与预估不一致时，按 /token-cost 的口径查缓存、倍率、计价单位，别先怀疑单价。
建议的动作是每周导出一次用量记录，字段按 /usage-log-fields 的清单对齐，月底核对时才有依据。平时不看，月底一次性对，基本只能靠猜。
一张排查顺序表：账单对不上时怎么走
账单对不上时，别一上来就怀疑单价变了。按下面这个顺序走，多数问题在前两步就能定位。这张表本身也是可以贴到团队文档里的操作清单。
| 顺序 | 看什么 | 常见结论 |
|---|---|---|
| 第一步 | 模型档位 | 调的是不是同一档模型，换档是最常见的金额跳变原因 |
| 第二步 | 计价单位 | 这次算文本量还是算秒/张，单位错了后面全错 |
| 第三步 | 额度状态 | 本周期免费额度是否耗尽转按量，还是付费池直接扣 |
| 第四步 | 计价口径 | 缓存命中、批量价、倍率有没有参与 |
| 第五步 | 单价变动 | 到 /price-watch 看追踪记录，别凭记忆下结论 |
- 前两步能覆盖大部分「金额跳变」的误判；
- 第三步决定的是「为什么本来不花钱却扣了」；
- 第四步最容易被忽略，缓存命中会让实际计费量低于你的直觉估算；
- 第五步才轮到单价，且要以追踪记录为准，不是以记忆为准。
常见问题
Gemini API 是按调用次数还是按 token 收费？
主要是按 token，但不是唯一维度。纯文本按输入输出分别计 token；涉及图像、语音、视频的调用常按秒、张或分辨率计，批量提交和缓存命中又可能落在不同计价档。所以第一件事不是记单价，而是确认你这次调用归哪一类单位，具体档位到站内官方价格页看当期口径。
免费额度用完会直接停，还是自动扣费？
两种都有可能，取决于你的账号和项目配置。有的配置是超了就拒绝请求，有的是转成按量计费继续跑。这个分叉必须在正式接入前确认，否则可能在一个没人盯的周末跑出一笔意料之外的账。查看方式在官方控制台的配额与结算设置里，站内只讲口径不替你确认。
账单和预估差很多，一般先查哪里？
按顺序查：模型档位、计费单位、免费额度是否耗尽、缓存和批量口径，最后才是单价是否变动。绝大多数差异出在前四项，尤其是换模型和单位搞错。排查思路可参照站内 token-cost 一页，单价变动则到价格追踪页看历史记录，不要凭记忆判断。
