API 返回 401 / 429 是什么意思？API Key 无效怎么办

·401 Unauthorized：Key 无效、写错、被吊销，或用错了协议（把 Anthropic Key 发到 OpenAI 端点）。

·403 Forbidden：Key 有效但无权访问该模型 / 分组，或来源被限制。

·429 Too Many Requests：触发限流或额度用尽，需要放慢频率或充值。

·5xx / 无可用渠道（distributor）：中转侧上游没有可用渠道，属于中转配置问题，通常重试或换渠道。

这类提示说明 Key 本身有效，但账户没钱了。换一个有额度的 Key，或到对应平台充值即可。检测工具遇到这种情况会在第一步就报出上游原文，方便定位。

先用官方直连或另一个已知可用的 Key 测同一个接口：如果换 Key 就好了，是 Key 的问题；如果换 Key 还报错，多半是中转地址 / 渠道的问题。

用 CheckToken 检测时，如果只是个别检测项报 HTTP 429 / 5xx，报告会照常出，并在顶部提示「部分检测项出现 API 错误，推荐重试」；如果连主探测都过不去，会直接透传上游错误原文。