Error Codes

8.1 HTTP 状态码

• 200: 请求成功
• 401: 用户鉴权失败
• 403: 后台鉴权失败
• 404: 资源不存在
• 422: 参数校验失败
• 500: 服务内部错误

8.2 业务错误码（chat/ai）

• 1001 UNAUTHORIZED
• 1003 SESSION_NOT_FOUND
• 1004 SESSION_FORBIDDEN
• 1005 POINTS_INSUFFICIENT
• 1006 SENSITIVE_BLOCKED
• 1007 PROVIDER_ERROR
• 1008 PROVIDER_FALLBACK_FAILED
• 1009 INVALID_REQUEST
• 1010 SUBSCRIPTION_REQUIRED
• 1011 MEMORY_SUBSCRIPTION_REQUIRED
• 9999 INTERNAL_ERROR

8.3 鉴权类错误

{"code":401,"detail":"请先登录后使用 AI 功能"}

{"code":403,"detail":"控制台未授权"}

8.4 积分/额度类错误

{"success":false,"code":1005,"message":"积分不足","data":null}

8.5 后台权限类错误

• 缺失 X-Console-Token
• Token 不匹配控制台配置

8.6 参数错误示例

{
  "code": 422,
  "detail": "请求参数错误",
  "errors": [
    {
      "loc": ["body", "question"],
      "msg": "String should have at least 1 character"
    }
  ]
}