谷歌api免费额度怎么获得

很多人卡在同一个位置：账号建好了，却不知道免费额度到底算在哪个项目上、在哪看还剩多少，key 建完调一次就报错也找不到原因。这篇按开通顺序走一遍：准备什么、在哪开通、怎么取 key、怎么确认额度生效，再给一份额度用不起来时的排查顺序。具体额度和模型名单会变，本文不写数字，一律指到站内对应页面核对当期口径。

开通前的三项准备

动手前先花十分钟把三件事确认清楚，能省掉后面一半的返工。很多人卡住不是不会点控制台，而是账号本身不在服务范围内，或者用途没想明白就乱开项目，最后免费额度用在哪都说不清。

1. 登录并确认账号可用换个干净浏览器登录，走一遍验证流程，看能不能正常进控制台。反复被要求验证或提示异常，先别急着开项目。
2. 核对账号地区在账号设置里看地区信息，对照站内服务覆盖说明判断能不能走下去。地区和人不一致时以账号地区为准。
3. 写下用途一句话自己写清楚「只在控制台里试跑」还是「要接进程序对外提供服务」，这句话决定后面开哪些开关。
4. 查当期计费口径开通前到站内价格与计费页面看当前规则，确认免费部分和付费项目是不是分开的开关，绑卡会不会直接产生扣费。

• 免费额度和付费项目通常是两套开关，开了免费不等于没开付费
• 绑卡这一步各家口径会变，开通前以站内当期说明为准
• 想接进程序的话，后面要开的项目、密钥、配额都跟单纯试跑不一样
• 账号只用来试跑还是长期用，最好从一开始就分开，混用容易互相踩配额

这三项确认完，再往下走开通步骤基本不会卡在奇怪的地方。具体当期价格、免费额度数字和计费规则别凭印象，到 /pricing 核对后再动手；地区覆盖的判断标准也可以在那附近找到对应说明。判断口径会调整，所以每次开通前重看一遍，比记一个旧结论靠谱。

从开通到拿到可用的 key

点开控制台后，第一件事不是急着找「生成 key」按钮，而是先把项目选对。免费额度是挂在项目这一层上的，调用时用的是哪个项目的 key，额度就算在哪个项目头上。手上有多个项目时，最省事的做法是专门留一个「额度测试」项目，别和线上业务混在一起，后面对账时一目了然。

1. 选定或新建项目在控制台顶部的项目选择器里挑一个已有项目，或者新建一个。建完先确认当前选中的就是它，别在 A 项目里选了服务、又切到 B 项目去生成 key。
2. 在对应入口生成 API key进到 API 凭据页面生成 key。生成弹窗里会显示 key 字符串，只显示这一次，当场复制走。
3. 立刻记下归属在密码管理器或团队笔记里写一行：key 别名、所属项目名、项目编号、用途、生成时间。这条记录后面排查「额度扣在哪个项目」时是唯一的线索。
4. 存进环境变量，别进仓库本地放 .env 并加进 .gitignore，线上走平台的密钥管理或环境变量注入。提交前扫一眼 diff，确认没有 key 字符串混进去。

同一个项目下可以开多个 key，这点值得用起来：一个给后端服务，一个给本地调试，一个给临时脚本。按用途拆开之后，某个 key 泄露了只需单独吊销，不影响其他调用方，也不至于把整个项目的额度一起暴露出去。key 的别名要起得能看懂，别用 key1、key2 这种。

key 拿到手先别急着写业务代码，用一次最小请求把链路走通：只发最简单的参数，看返回是不是预期的结构，而不是错误码或空响应。这一步能提前暴露服务没启用、key 填错、项目选错这类问题。等最小请求稳定返回了，再往上叠业务逻辑，排查面会小很多。具体各服务的开通入口和当前额度范围，去 谷歌 API 免费额度指南（/guides/google-api-free-quota） 核对当时的说明；费用相关的数字到 API 价格页（/pricing） 看实时数据。

确认免费额度真的生效了

调用返回 200 不代表这笔请求走的就是免费额度。控制台里的用量视图才有发言权：看这笔调用有没有被记进当前项目的用量。记进去了，说明 key、项目、计费通道三者对得上；没记进去，先别怀疑额度没了，八成是看错了项目或 key 绑到了别的项目上。

要分清两件事：一是「调用成功」，二是「走的是免费档」。同一个模型名，免费和付费两条通道可能同时存在，接口能通只说明前者成立。到底哪个通道算免费、额度怎么算，以站内模型与价格页面的说明为准，别凭印象判断。

1. 先给项目起个能认出的名字把默认名改成带用途和负责人后缀的名字，比如「测试-小明」。多个项目同时开着的时候，这一步能省掉大量「到底看的是哪个项目」的来回排查。
2. 进用量视图对一笔具体调用挑一次刚发出的请求，按时间对上去，确认它落在哪个项目、哪个模型下。对上了再做后续判断。
3. 换 key 之前先换项目视角没看到记录时，先把控制台项目切到其他候选项目各看一遍，确认不是视角问题，再去动 key 或重新申请。

这套判断也有不适用的时候：如果你在多个项目里共用同一把 key，或者团队里有人也在用同一个项目做调试，用量视图会把别人的调用一起算进来，单看总量无法确认是你这次调的。这种情况下按时间窗口对单笔调用，或者给不同用途单独开项目，别混在一起用。

额度用不起来时的排查顺序

额度看着有、请求却调不通，别急着认定是免费额度没了。这类问题八成出在四层上：项目、模型、账号、请求本身。按下面顺序往下查，每层都先确认再往下走，别一上来就换 key 或重开项目，那样只会把问题弄得更乱。

1. 第一步：确认 key 挂在哪个项目很多人手里有好几个项目，key 是在 A 项目建的，账单和额度却盯的 B 项目。打开控制台看这个 key 属于哪个项目，再对比你查额度的那个项目是不是同一个。验证方法：新建一个只用当前 key 的最小测试请求，看控制台里该项目下的调用记录有没有出现这一次。
2. 第二步：确认当前模型在免费范围内同一个 key 调 A 模型能用、调 B 模型报错，基本就是模型不在免费覆盖里。模型清单和覆盖情况以站内资料库为准，别凭记忆判断。验证方法：换成清单里明确标了免费/有额度的同系列模型再发一次同样的请求，能通就说明是模型选错了。
3. 第三步：查地区和账号状态项目没问题、模型也对，就看账号本身：注册地区是否支持该服务、账号是否处于受限或待验证状态、有没有触发风控。验证方法：控制台里找账号状态和结算页的提示，有没有待处理的通知或验证要求，有就先处理掉。
4. 第四步：查请求参数与频次限制前面都正常还调不通，问题大概率在请求本身：必填参数缺失或格式不对、单次请求体太大、并发太高、短时间调用次数超过限速。限速被拒经常表现成「调不通」而不是报额度不足，容易误判。验证方法：把并发降到 1，请求间隔拉开，用最小参数发一次；能过就是限速或参数问题。

• 排查时一次只改一个变量，改完立刻复测，否则不知道是哪一步起了作用
• 每层都留下证据：项目名、模型名、报错原文、请求时间，方便后面复查
• 别用生产 key 做排查，单独建一个测试 key，排除影响
• 确认是额度问题再去看站内额度与价格页面，别把限速、参数错误都算到额度头上