# 错误码

## 错误响应格式

所有错误返回统一的 JSON 格式：

```json
{
  "error": {
    "message": "错误描述",
    "type": "error_type"
  }
}
```

## 状态码

| HTTP 状态码 | 含义 | 处理建议 |
| --- | --- | --- |
| `400` | 请求参数错误 | 检查 `model`、`messages` 等必填字段 |
| `401` | 认证失败 | 检查 API Key 是否正确且未撤销 |
| `402` | 余额不足 | 请先充值 |
| `429` | 请求频率超限 | 降低请求频率，当前限制 60 RPM |
| `502` | 上游服务错误 | 模型提供方暂时不可用，稍后重试 |
| `503` | 服务不可用 | 系统维护中，稍后重试 |

## 重试建议

- `429` -- 使用指数退避重试，最大间隔 60 秒
- `502` / `503` -- 等待 5-10 秒后重试，最多重试 3 次
- `400` / `401` / `402` -- 不要重试，修正请求参数或账户状态