常见报错码怎么读

401 / 402 / 404 / 429 / 5xx 分别代表什么、先查什么。

401 未授权

令牌无效、被删除或写错了。先确认 Authorization 头的格式是 Bearer sk-xxx,注意 Bearer 后面有一个空格。

402 额度不足

余额不够本次请求的预扣。充值后立即恢复,不需要改任何配置。

404 找不到

九成是地址写错。确认用的是 https://api.router.ai/v1/..., 且没有把 /v1 写重或漏写。也可能是模型名拼错——模型名以「模型广场」为准。

429 频率限制

触发了限流。降低并发或稍后重试;持续需要更高并发请联系我们。

5xx 上游异常

上游模型服务出问题。我们会透传上游的原始错误体便于定位。 这类通常是暂时的,重试即可;如果某个模型持续 5xx,请反馈给我们。

排查顺序建议:先看状态码 → 再看返回体里的 message → 最后查计费流水。 如果计费流水里根本没有这笔,说明请求没到达我们,问题在客户端配置。

博客