免费 API 排障
同一个 API key 为什么仍会触发 429
查清是分钟请求、每日请求还是 token 限额耗尽,再决定降低并发、缩短输出或延期。
确认实际使用的项目或组织
Gemini 的 API 限额按项目计算,Groq 的文档说明限额适用于组织。同一范围内的其他工具和 key 也可能占用共享额度。
记录模型 ID、请求时间和使用范围,同时排查有没有其他任务或测试脚本在运行。
定位用完的是哪项限额
结合供应商控制台和应用自己的计数,分别核对分钟请求、日请求和 token。部分 Groq 组织还有独立的输入、输出 token 限额。
Groq 的 x-ratelimit-remaining-requests 反映每日请求余量。该字段有剩余时,仍要查分钟请求和 token 限额。收到 retry-after 时,至少等待它指明的时长。
按耗尽的额度调整
分钟限额用尽时,降低并发或缩小 token 用量。日请求限额用尽时,暂存工作并等待恢复。Gemini 文档列明日请求额度在太平洋时间午夜重置。
依赖免费路线前,用自己的控制台确认账号和模型资格、实际额度,并记录核对日期。Muse 整理来源和初稿,FreeToken 核对引用。本指南未调用模型 API 或实测账号资格。