# 错误码与排查

先看 HTTP 状态码，再看错误正文和请求日志。下面是常见情况，具体错误类型以实际部署返回为准。

## 常见状态码

| 状态码 | 常见情况 | 排查方向 |
| --- | --- | --- |
| `400` | 请求参数不符合接口要求 | 检查 JSON、模型 ID 与支持的参数 |
| `401` | 认证信息缺失或无效 | 检查 Bearer 请求头与密钥 |
| `403` | 请求不被允许 | 根据错误信息检查模型、分组与账户权限 |
| `429` | 请求受到限制 | 检查限流信息，按建议等待后重试 |
| `500` / `502` / `503` / `504` | 服务或上游异常 | 保存请求 ID，查看日志与模型状态 |

## 分步排查

1. 确认 Base URL，只包含一次 `/v1`。
2. 使用模型广场中的完整 ID，检查模型和密钥是否属于可用分组。
3. 缩减为最小请求，暂时去掉可选参数。
4. 在调用日志中查看错误信息与请求 ID。
5. 对照模型状态页，判断是否存在异常或没有样本。