常见错误码

平台出错时统一返回如下结构（与 OpenAI / Anthropic 的错误格式兼容），便于各类 SDK / 客户端自动识别：

json

{
  "error": {
    "message": "Invalid or missing API key",
    "type": "authentication_error"
  }
}

HTTP 状态码

状态码	`error.type`	含义
401	`authentication_error`	API Key 缺失或无效。请检查 `Authorization: Bearer <key>`（或 `x-api-key`）是否已正确传入。
402	`billing_error`	账户余额不足。请前往钱包充值后重试。
404	`not_found_error`	未指定模型，或指定的模型不存在 / 未开通。请求中的 `model` 需为平台支持的模型 id。
429	透传上游	上游限流，错误消息由上游供应商直接透传。稍后重试或换用其他模型。
500	`configuration_error`	服务端配置异常，通常是供应商路由配置问题，已自动上报。如持续出现请联系我们。
502	`api_error`	上游服务连接失败（网络不可达或上游短暂异常），建议重试。
其他 4xx / 5xx	透传上游	上游供应商直接返回的错误（如模型内容审查、请求体格式错误等），原始错误体会透传给客户端。

json

{
  "error": {
    "message": "Invalid or missing API key",
    "type": "authentication_error"
  }
}

排查：

确认请求头中带了 Authorization: Bearer <API_KEY>（OpenAI 协议）或 x-api-key: <API_KEY>（Anthropic 协议）。
确认 Key 在 API Keys 页面仍然有效、未被删除。

json

{
  "error": {
    "message": "Insufficient balance",
    "type": "billing_error"
  }
}

排查： 前往钱包充值。

json

{
  "error": {
    "message": "No provider for model 'gpt-x'. Available: claude-sonnet-4-6, gpt-5.3-codex, ...",
    "type": "not_found_error"
  }
}

排查：

json

{
  "error": {
    "message": "Upstream connection failed",
    "type": "api_error"
  }
}

排查： 通常为上游供应商短暂不可达，建议重试；如长时间复现，请联系我们。