> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiohub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP 状态码

> API 返回的 HTTP 状态码说明与处理建议。

## 常见状态码

| 状态码     | 含义      | 处理建议                                           |
| ------- | ------- | ---------------------------------------------- |
| **200** | 请求成功    | 正常响应                                           |
| **400** | 请求参数错误  | 检查请求体 JSON 格式和参数                               |
| **401** | 鉴权失败    | 检查 API 令牌是否正确、是否过期                             |
| **403** | 无权访问    | 确认 API 令牌的分组包含请求的模型和端点，必要时按客户端页面核对协议与 Base URL |
| **404** | 端点不存在   | 检查请求 URL 是否正确                                  |
| **413** | 请求体过大   | 减小请求体大小后重试                                     |
| **429** | 请求频率超限  | 降低请求频率，检查控制台公告或当前限额                            |
| **500** | 服务器内部错误 | 稍后重试，保留请求 ID 和错误信息                             |
| **503** | 服务暂时不可用 | 模型暂无可用容量或上游故障，稍后重试或切换模型                        |
| **524** | 请求超时    | 网络延迟或请求内容过大，检查网络后重试                            |

## 错误响应格式

```json theme={"system"}
{
  "error": {
    "message": "错误描述信息",
    "type": "error_type",
    "code": "error_code"
  }
}
```

## 重试建议

* **4xx 错误**（客户端错误）：修复请求后重试，无需等待
* **429**：等待后重试，建议使用指数退避
* **5xx 错误**（服务端错误）：等待几秒后重试