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

# 常见错误码

> 排查请求失败时的 HTTP 状态与 error 字段

## HTTP 状态码

| 状态        | 含义        | 处理建议                    |
| --------- | --------- | ----------------------- |
| 401       | Key 无效或未传 | 检查 Authorization Header |
| 403       | 无权限访问该模型  | 确认分组与模型限制               |
| 429       | 触发限速      | 降低 QPS 或联系管理员           |
| 402       | 余额不足      | 充值或调整配额                 |
| 500 / 502 | 上游或网关异常   | 稍后重试，查看服务状态             |

## 错误响应格式

OpenAI 兼容错误通常包含：

```json theme={null}
{
  "error": {
    "message": "...",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}
```

Claude / Gemini 原生格式各有差异，请以响应 body 中的 message 为准。