错误码总表
网关错误分三层：入口鉴权与准入（401 / 403 / 404 / 400）、额度与计费（402 / 429）、上游转发（502 及透传的上游状态码）。先按状态码分层，再看错误体的 type 与 message。
最后更新：2026-11-14
| 状态码 | 错误标识（code 或 error） |
常见原因 |
|---|---|---|
| 400 | model_protocol_not_supported |
模型未声明该协议 |
| 400 | model_endpoint_not_supported |
模型未声明该端点 |
| 400 | unsupported protocol |
路径无法识别协议 |
| 401 | missing api key / invalid key format |
未带密钥 / 前缀不对 |
| 403 | model_not_allowed |
密钥绑定的模型清单不含该模型 |
| 403 | model_offline |
模型已下架 |
| 403 | model_not_priced |
模型未配置计费规则 |
| 404 | — | 路径不存在（Base URL 拼错等） |
| 402 | insufficient balance |
余额不足 |
| 413 | body_too_large |
请求体超过上限 |
| 429 | rate limit exceeded / user rate limit exceeded |
触发限流 |
| 503 | no available channel |
无可用渠道 |
| 5xx | — | 上游或网络异常，可重试 |