常见错误

下面这些状态码和错误消息，是当前系统里最常见的一批。

错误格式

OpenAI 兼容接口通常返回：

{
  "ok": false,
  "error": {
    "message": "..."
  }
}

如果是上游请求失败，error 里还可能额外带 upstreamStatus。

Anthropic Messages 则返回 Anthropic 风格错误对象：

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  }
}

常见状态码

• 400：请求体或参数不合法，常见消息包括 Invalid JSON request body、Request body must be a JSON object。
• 401：鉴权失败。网关 API 常见消息包括 API token is required、Invalid API token；控制台登录态接口常见消息包括 Bearer token is required、Invalid bearer token、Bearer token expired。
• 402：余额或额度不足，常见消息包括 Insufficient balance、Daily time package quota exhausted。
• 403：权限或风控限制。
• 404：资源不存在。
• 409：业务冲突。
• 413：请求体过大。
• 429：请求过于频繁，或者当前 provider group 的并发额度打满。
• 502/503：上游服务异常。
• 500：服务内部错误。