CC-019：429 Rate Limit Exceeded / insufficient_quota

问题现象

调用过程中请求中断，终端输出含 429 字样，例如：

API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}

或：

API Error: 429 {"type":"error","error":{"type":"insufficient_quota","message":"..."}}

当前请求被服务端限流或被第三方网关以 429 拒绝；错误体的含义取决于最终响应方。

先区分最终请求域名和错误类型：

子类型	含义	是否自动恢复
`rate_limit_error`	短时间请求过于频繁	是，等待后自动恢复
`insufficient_quota` 或网关余额提示	常见于第三方兼容网关，不能直接归因于 Anthropic	按该网关正式账单说明处理

第一步：判断子类型

先用 /status 核对 Base URL，并在对应服务的控制台查看用量和限制。不要在报错截图中显示 Key、账单或私人账号信息。

第二步：处理频率限制

遵守服务端返回的重试时间，降低并发并使用指数退避；不要用轮换账号或批量 Key 规避速率限制。

第三步：处理额度耗尽

如果最终域名是第三方网关，只在其登录后的正式账单页核对额度、价格和退款规则。本站与该网关的商业或关联关系尚待运营方披露，因此本页不把充值写成唯一处理方式。

做法	避免的问题
遇到 429 先查 Console 用量，再排查配置	避免额度耗尽时在 Key 配置上浪费时间
对自动化请求使用退避与并发上限	避免持续触发服务端限制