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

# 系统级错误

系统级错误由平台自身产生，常见于账户状态、令牌状态、权限与策略等场景。此类错误会返回固定格式的 JSON，便于程序统一处理。

## 固定错误格式

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "error": {
    "message": "Token is expired.",
    "type": "forbidden",
    "source": "system",
    "details": {
      "request_id": "2026010914011404810445",
      "note": "This error was generated by the system, not from any upstream provider."
    }
  }
}
```

字段说明：

* `error.message`：可读错误信息
* `error.type`：错误类型（用于程序分支处理）
* `error.source`：固定为 `system`
* `error.details.request_id`：请求 ID（排查用）

## 常见触发场景

* 账户余额不足
* 令牌过期 / 被禁用 / 不可用
* 权限不足或策略拦截

## 如何识别

查看响应头：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Poixe-Error-Source: system
Poixe-Request-Id: <request_id>
```

## 处理建议

* 余额相关：检查账户余额与令牌状态
* 令牌相关：确认是否过期/被禁用，并更新配置
* 持续无法定位：携带 Request ID 联系团队