API 401、403、429 是什么意思？新手最常见报错一次讲清楚
第一次用 AI API，很容易看到：
401
403
404
429
500
然后完全不知道问题在哪。其实不用一看到错误就重新装软件。状态码本身已经给了很多信息。
401
通常是身份验证失败。重点检查：API Key、Key 是否复制完整、Key 是否被删除、Key 是否过期、当前平台是否正确。
403
通常是没有权限。Key 可能存在，但无法访问当前的模型、Organization、Workspace、资源。
404
优先检查：Base URL、/v1、Endpoint、Model。
429
429 = Too Many Requests。一般表示：请求太频繁、Token 超过速率限制、当前账户达到 Rate Limit。
OpenAI 官方明确说明，429 可能由组织级每分钟请求数或 Token 数限制触发。不要遇到 429 就无限快速重试，应该使用退避重试或者降低并发。
500 / 502 / 503
通常更偏向服务端问题。如果偶发，稍后重新请求；如果长期出现，检查上游服务状态。