文档目录
错误码
常见 HTTP 状态码的含义和处理办法。
接口返回非 2xx 状态码时，先对照下表。排查连通性时可以先用 curl 复现。
| 状态码 | 含义 | 怎么处理 |
|---|---|---|
400 | 请求格式或参数不正确 | 检查请求体 JSON、必填字段（如 model、messages、Anthropic 的 max_tokens）和接口路径是否匹配。 |
401 | 密钥无效或已停用 | 确认密钥完整、没有多余空格，且在 API 密钥 页处于“启用”状态。 |
402 | 余额或订阅不足 | 查看余额并联系管理员充值，见 注册与充值。 |
404 | 模型或接口路径不存在 | 模型名需与 模型定价 页完全一致；检查接入地址是否多带或少带了 /v1。 |
429 | 触发并发或速率限制 | 降低并发和请求频率，稍等片刻后重试；客户端建议加指数退避。 |
503 | 上游暂不可用，已自动切换线路 | 稍后重试。如果持续出现，可到 服务状态 页查看对应模型是否异常。 |