为什么付费项目还显示免费额度为零？

错误反映本次请求实际应用的额度。先查真正使用的 Key 所属项目、模型额度和账单状态；仅看付费页面不能确定原因。

limit: 0 时应该一直重试吗？

重试提示不会产生正额度。先核项目和额度状态；对临时限流采用有上限的退避，不要无限循环。

不一定。模型额度和权限可能不同，要查看准确的图片型号与 quotaMetric。

Gemini 生图返回 429 RESOURCE_EXHAUSTED，错误里又有 free-tier 指标和 limit: 0 时，先核对额度指标及实际 API Key 所属项目。 账户有余额，不足以解释这次请求究竟用了哪项额度；错误里建议等待几秒，也不会自动把零额度变成可用额度。

本文针对 Gemini Developer API。Vertex AI 和第三方网关的配置方式不同，排查要以实际调用服务为准。

2026 年 9 月 7 日，Google AI 开发者论坛一位用户反馈：项目显示 Paid Tier 1 / Postpay，文字请求正常，但调用 gemini-3.1-flash-lite-image 生图返回免费额度指标和零限额。

这是官方论坛上的用户报告，不是 Google 已确认的全平台故障。截至 9 月 9 日本次核查，没有从该帖获得已确认的根因或修复。它说明这类现象值得排查，不能说明所有付费用户都会遇到，也不能证明充值一定能解决。

配额规则依据 Google 排查指南和限额说明。结合真实错误与项目当前页面判断，别套用别人的额度数字。

保留脱敏错误信息：状态码、model、quotaMetric、quotaId、实际限额及重试提示。不要公开 API Key 和私有项目标识。

表格说明检查方向，不是让你重建一份响应。不同 SDK 的展示方式可能不同，保留原始字段更便于提交问题。

检查实际运行环境：Key 来自本地变量、部署密钥、工作流凭证，还是代理配置？测试工具能成功，不代表线上应用用了同一个 Key。

在 AI Studio 或对应 Google Cloud 控制台找到该 Key 所属项目，对照你查看付费状态和配额的项目。如果不一致，修正为预期且有权限使用的项目。不要轮换无关 Key 来规避限额；官方说明配额按项目而不是按 Key 计算。

更改密钥配置后，确认运行中的部署已加载。调试时不用打印密钥内容，项目归属和脱敏凭证名称已经足够用于核对。

在正确项目中查看具体图片模型的额度与当前用量。文本模型能用，不代表图片模型额度也可用。余额、Tier 和实际请求中出现的 free-tier 指标，需要一起解释。

如果页面显示和错误内容矛盾，把两者连同时间保存下来。根据当前账单说明核对项目关联、Prepay/Postpay 和账单状态；不要把预付余额检查当成所有后付费项目的通用根因。

近期改过项目或账单配置，可以检查变更是否仍在生效。如果持续矛盾，应携带证据联系支持，而不是直接认定“再买一点额度就好”。

非零额度下的临时限制，可以降低并发、采用有上限的指数退避，并参考重试提示。先看 SDK 是否自带重试，避免外层再套循环把请求次数放大。

对持续为零的实际额度，先解决或核实项目状态。等待可以用于观察刚做的配置变更，但无限重试不会修复持续存在的零额度。换提示词也不能证明配额问题得到修复。

提供时间和时区、准确型号、调用服务、SDK 版本、脱敏额度字段，以及同一项目的账单和限额状态。项目 ID 通过私有支持渠道提交，并说明单次请求是否也失败，还是只有并发时失败。

把观察和推断分开：“响应应用了 free-tier 指标，限额是零”比“账单系统坏了”更利于定位。后续若验证修复，记录具体变更和下一次响应，不要把所有尝试都当成有效修法。

一般重试问题可看429 怎么判断是否该重试。若评估其他生图服务，GPT Image 2.5 接入和计费说明介绍的是另一套凭证和费用，不能替代修复原项目的配额。