gemini api key 免费 额度

接 Gemini API 时最容易踩的坑，是把「免费额度」当成一个固定数字记在脑子里，结果换了模型、换了调用方式、或者项目从测试变成上线，额度口径就完全不一样了。这篇不给你背数字，而是帮你分清免费层覆盖哪些模型和调用形态、哪些情况会直接走付费或报错、以及去哪里核对当期真实额度。

接 Gemini API 时最容易踩的坑，是把「免费额度」当成一个固定数字记在脑子里。结果换了模型、换了调用方式，或者项目从测试变成了上线，额度口径就完全不一样了。这篇不给你背数字，而是帮你分清免费层覆盖哪些模型和调用形态、哪些情况会直接走付费或报错、以及去哪里核对当期真实额度。

判断顺序建议固定成三步：先看你要用的模型和调用入口在不在免费范围内，再看限制卡在哪条线上，最后看你这套用法的失败代价能不能承受。三步里任何一步答不上来，就别急着写业务代码，先去站内把当期数字核一遍。

免费额度到底覆盖了什么

免费层的额度不是账户级的一个总数，而是按模型、按调用界面分别给的。同一把 Key 调不同模型，消耗的是不同池子；调同一个模型但走流式、批处理、文件上传这类不同入口，也可能落在不同口径里。所以「我这把 Key 免费额度还剩多少」这个问题本身就不成立，得先问「我要用的那个入口还剩多少」。

能不能免费用

这个模型和这个调用入口是否在免费范围内，不在范围里就是直接报错或计费，跟你剩多少额度无关

免费给多少

在范围内的部分，按请求数、token 数、每分钟请求数等不同单位分别设限

超额之后怎样

是直接拒绝、排队限速，还是自动转到付费档，这由账户设置决定，不是固定的

还有一点常被忽略：免费层通常不包含某些高级能力，比如更长的上下文、特定的多模态输入、批处理通道等。这些位置按付费档口径走，你在测试时用短提示词跑通了，不代表换成真实长度的输入还能留在免费层里。

• 先确认模型在不在免费范围，别先算还剩多少；
• 再确认调用入口（单次 / 流式 / 批处理）是否同属免费口径；
• 最后确认超额行为是拒绝还是转付费，避免半夜跑飞；
• 三步都确认完，再去控制台看已用量才有意义。

额度去哪看、按什么单位看

控制台里的用量面板和 API 官方价格页是两套东西。前者告诉你已经用了多少，后者告诉你计费单位和免费范围。只看其中一个都判断不了，必须对着看：用量面板说你这个月跑了多少，价格页说这个模型哪些用量是免费的、超出后怎么算。

按什么单位看很关键。请求数、token 数、每分钟请求数通常各有各的上限，先卡到哪条就先在哪条上撞墙。有人以为额度还很多，其实是每分钟请求数先满了；也有人以为限速放宽了就够用，结果 token 池早就见底。免费层的限制多是滚动窗口而非自然月，刷新节奏决定你什么时候能继续跑。

什么时候免费额度一定不够用

开发调试阶段通常够用，单人、低频、短输入，基本不会撞墙。但有几类场景，免费层基本必然不够，而且问题不只是额度，还有稳定性和可追溯性。

• 批量跑数据、离线清洗：调用量集中在短时间，最先撞的是每分钟限制；
• 定时任务或后台作业：失败没人盯，超额后是拒绝还是降速你未必第一时间知道；
• 多用户共用一把 Key：用量来源混在一起，出了问题定位不到是谁；
• 需要稳定响应时间的线上功能：免费档在高峰期常有限速或排队，这不是额度多少能弥补的。

什么情况下不适用这套判断：如果你只是做一次性验证、跑几次就丢的脚本，或者调用完全发生在本地、不面向任何用户，那免费层的限速和稳定性问题对你影响很小，不用急着切。判断标准可以简化成一句：如果这个调用失败会直接影响到你的用户，就不要把它放在免费层上。

从免费层切到付费前的核对清单

决定切付费之前，别只盯着「额度不够了」这一个信号。先做用量盘点，把过去一段时间的调用按模型和任务类型拆开，看哪一类占了大头。很多时候是某个批量任务把额度吃光了，把那个任务单独挪走，剩下的日常调用其实还能留在免费层。

1. 拆用量按模型和任务类型分组统计调用量，找出真正的消耗大户，验证方法是对比拆走前后每天的已用量曲线。
2. 对齐计价口径付费档按 token 计费时，输入和输出通常分开算，长提示词和长输出会明显放大成本，先用真实长度的样本试算一遍再到站内价格页核对当期数字。
3. 设预算告警在控制台把预算告警打开，别等账单出来才知道跑飞了，验证方法是故意触发一次小额告警看能不能收到通知。
4. 比档位把官方价目与订阅档位放在一起比一遍，注意不同档位在限速和高级能力上的差异，不只看单价。

这份清单的价值不在于帮你省钱，而在于让你知道自己为什么切、切过去之后哪条线会先被撞到。如果盘点完发现消耗大户只是测试残留的脏任务，那清理任务比切档更划算。

免费额度不是一笔存款，而是一组按模型和入口分别失效的规则，先搞清规则，再谈够不够。