Gemini API 报错 403 PERMISSION_DENIED、Your API key was reported as leaked 怎么办（2026）
大约 2 分钟GeminiGemini API403 PERMISSION_DENIEDAPI key was reported as leakedFree tier unavailableGemini API报错
一句话结论
403 PERMISSION_DENIED 不是限流，重试没用。先在 Google AI Studio 看项目状态：显示 Free tier unavailable 就要关联结算账号升级付费层；显示 Payment needed 就去补缴欠款；报错写着 API key was reported as leaked 就生成新 key。
阅读说明
官方信息查阅日期：2026-10-24。来源：Gemini API 官方 Troubleshooting guide（页面标注 2026-10-23 更新）。
按项目状态对照
| AI Studio 显示 / 报错内容 | 原因 | 怎么办 |
|---|---|---|
| Free tier unavailable / Restricted | 该 Google Cloud 项目没有免费层资格 | 关联有效的 Cloud Billing 账号，升级付费层 |
| Payment needed / 提到 outstanding balance | 结算账号有欠款 | 在 AI Studio 结算页或 Google Cloud 结算控制台补缴、更新付款方式，恢复后自动解除 |
Your API key was reported as leaked. Please use another API key. | key 被判定公开泄露，已被封禁 | 在 AI Studio 的 API Keys 页生成新 key，更新到应用里 |
| 项目或结算账号被暂停 | 违反政策 | 查看关联邮箱里的通知，在 Google Cloud 控制台查看暂停说明 |
免费层不可用的细节
- 资格按 Google Cloud 项目评估，在同一项目里新建 key 解决不了。
- 要继续用这个项目，只能关联结算账号升级付费层。
- 升级到付费层不会解锁免费层额度，付费用量按官方价格计费，或从符合条件的 Google Cloud 赠送额度里扣。
key 被判定泄露
官方说明：发现部分 API key 被公开暴露后，Google 会主动封禁这些 key 调用 Gemini API。
- 在 AI Studio 可以看到哪些 key 被封；
- 生成新 key，不要把 key 写进前端代码或公开仓库；
- 因泄露产生了意外费用，提交结算支持工单。
一个容易误判的地方
models.list（GET /v1beta/models）这类只读接口只检查 key 是否存在，不检查项目资格和结算状态。它返回 200 OK 不代表 generateContent 等推理调用能用。
相关阅读
参考来源（官方）
- Gemini API · Troubleshooting guide（Project restricted or unavailable；Blocked or non-working API keys）：https://ai.google.dev/gemini-api/docs/troubleshooting（查阅日期：2026-10-24）