错误码说明

接口出错时会返回标准 HTTP 状态码及 JSON 错误体，便于快速定位问题

遇到非 2xx 响应时，可参考下表排查原因

状态码	含义	说明
401	鉴权失败	API Key 缺失、错误或已被禁用，请检查 Authorization 头是否正确携带 Bearer sk-xxxxxxxx
403	余额不足或无权限	账户余额不足以完成本次调用，或当前 Key 没有访问该模型/分组的权限
404	资源不存在	请求的模型或接口路径不存在，请检查 model 字段与 URL 拼写
429	请求过于频繁	触发限流，请降低请求频率或联系客服提升限额
500	服务端错误	上游模型或服务端出现异常，请重试，若持续出现请反馈给客服
503	服务暂时不可用	上游渠道维护或过载，建议稍后重试或更换模型

所有错误均返回统一的 JSON 结构，可据此编写自动重试/告警逻辑

{
  "error": {
    "message": "Incorrect API key provided: sk-xxxxxxxx",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}