请求排查
AI API 错误 429：速率限制、余额和支出上限
429 是请求限制响应，不能证明提供方发生故障。重试前请查看提供方的错误代码、消息和重试标头。
简要回答
429 是请求限制响应，不能证明提供方发生故障。重试前请查看提供方的错误代码、消息和重试标头。
各提供方文档说明
OpenAI 区分请求频率限制、积分耗尽和组织／项目限制。请检查 error.code；对计费或用量限制重试不会恢复访问。
Claude 对请求限速和部分支出上限使用 rate_limit_error。使用等级支出上限响应没有 retry-after 响应头。流量快速增长也可能触发请求限速。
Gemini 将 429 RESOURCE_EXHAUSTED 列入可能适合指数退避的错误。在将限制视为暂时问题前，应检查错误详情。
建议的应用处理方式
对于暂时请求限速，降低请求并发，遵循已提供的重试延迟，并设置最大尝试次数和总截止时间。考虑 SDK 已执行的重试。缺少重试响应头本身不能确认原因。
保留脱敏后的错误正文与请求 ID。错误表示积分或支出限制时，请私下检查账户配置，不要发布凭据。将对应 API 状态范围与请求证据对照。
相关服务页面
每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。
编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。