这是无法通过退避重试修复的 429。insufficient_quota 意味着你的账户没有可消费的余额——请求在任何模型运行前就被拒绝，并且会持续被拒绝，直到计费状态发生变化。下面介绍如何确认当前所处的计费状态，并在几分钟内解除问题。
错误
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}原因和解决方法一览
| 原因 | 解决方法 |
|---|---|
| 预付余额为 $0 | API 采用预付模式：在 Settings → Billing 下购买余额（或启用自动充值）。仅保存银行卡并不会增加余额，必须先购买余额。 |
| 免费试用余额已过期或已用完 | 试用额度会过期（通常为 3 个月后），即使一直未使用也一样。解决方法相同：添加支付方式并购买余额。 |
| 达到月度预算上限 | 你在 Limits 下自行设置的预算达到上限后，会阻止当月剩余时间的请求。提高上限，或等待月份重置。 |
| 密钥属于没有预算的项目或组织 | sk-proj- 密钥从所属项目的预算中消费；项目可以拥有低于组织的独立上限。在控制面板中检查密钥所属的项目，而不只是组织总额。 |
确认这是配额问题，而不是速率限制
读取 error.type。rate_limit_exceeded 会在一分钟内自行解除，应进行退避；insufficient_quota 不会自行解除，重试只是制造噪声。如果不确定，等待 60 秒后重试一次即可确认：如果仍然是带有相同消息的 429，就说明是计费问题。
检查该密钥实际使用的余额
在 platform.openai.com → Settings → Billing 中查看余额。余额为零或负数时，购买余额。然后在 Settings → Limits 中检查月度预算上限；对于 sk-proj- 密钥，还要检查所属项目自身的使用量限制。这三项中的任何一项都可能独立产生此错误。
消除反复发生的原因，而不只是处理这次故障
启用自动充值并设置合理的阈值，避免繁忙周末导致生产环境停止运行；同时设置预算提醒，而不只是设置硬上限，以便在请求开始失败前收到接近上限的通知。
如果你通过 Kunavo 调用
Kunavo 采用相同的预付模式，因此诚实的比较应关注余额的影响范围，而不是机制本身：一个 Kunavo 余额可同时覆盖 GPT 和 Claude，按令牌计价，失败请求永不计费。当 Kunavo 自身余额耗尽时，你会收到带有 insufficient_quota 代码的 402（特意使用相同代码，因此 OpenAI SDK 的错误处理可以直接沿用）；充值后会立即解除问题，无需处理月度上限。 如果要为解决方案做预算，当前 GPT 的每令牌价格以及 OpenAI 官方公开价格与我们的价格对照，请参阅 GPT API 价格表.
常见问题
我已经添加了信用卡，为什么仍然收到 insufficient_quota？
因为 API 消耗的是预付余额，而不是直接扣信用卡。添加信用卡只会启用购买功能；你仍然需要购买余额或开启自动充值。余额变为正数后，错误会在一两分钟内解除。
insufficient_quota 会自行修复吗？
只有一种情况会：月度预算上限会在月份切换时重置。零余额和试用期过期这两种情况会持续存在，直到你购买余额。无论哪种情况，重试循环都没有帮助——请求在任何模型运行前就已被拒绝。
失败的 429 请求会产生费用吗？
不会——OpenAI 会在推理前拒绝这些请求；在 Kunavo 上，失败请求也永远不会计费。真正的代价是停机时间，因此自动充值加预算提醒比单独设置硬上限更有效。