# AI API 错误 429：速率限制、余额和支出上限

429 是请求限制响应，不能证明提供方发生故障。重试前请查看提供方的错误代码、消息和重试标头。

作者：IsAnythingDown. 核对于 2026-10-06.

规范页面： https://isanythingdown.com/zh-cn/guides/ai-api-error-429

## 简要回答

429 是请求限制响应，不能证明提供方发生故障。重试前请查看提供方的错误代码、消息和重试标头。

## 各提供方文档说明

OpenAI 区分请求频率限制、积分耗尽和组织／项目限制。请检查 error.code；对计费或用量限制重试不会恢复访问。

Claude 对请求限速和部分支出上限使用 rate_limit_error。使用等级支出上限响应没有 retry-after 响应头。流量快速增长也可能触发请求限速。

Gemini 将 429 RESOURCE_EXHAUSTED 列入可能适合指数退避的错误。在将限制视为暂时问题前，应检查错误详情。

- [OpenAI API 错误码](https://developers.openai.com/api/docs/guides/error-codes)
- [Claude API 错误](https://platform.claude.com/docs/en/api/errors)
- [Gemini API 排查](https://ai.google.dev/gemini-api/docs/troubleshooting)

## 建议的应用处理方式

对于暂时请求限速，降低请求并发，遵循已提供的重试延迟，并设置最大尝试次数和总截止时间。考虑 SDK 已执行的重试。缺少重试响应头本身不能确认原因。

保留脱敏后的错误正文与请求 ID。错误表示积分或支出限制时，请私下检查账户配置，不要发布凭据。将对应 API 状态范围与请求证据对照。

- [如何理解 AI API 错误](https://isanythingdown.com/zh-cn/guides/ai-api-error-codes)

## 相关服务页面

- [OpenAI API](https://isanythingdown.com/zh-cn/services/openai)
- [Claude](https://isanythingdown.com/zh-cn/services/claude)
- [Gemini API / AI Studio](https://isanythingdown.com/zh-cn/services/gemini-api)
- [OpenRouter](https://isanythingdown.com/zh-cn/services/openrouter)

每个条目显示自己的采集覆盖。链接到服务不一定表示自动采集。

编辑审核日期适用于本指南。实时报告采集时间显示在服务页面。