错误处理

错误返回的格式、常见状态码和重试建议。

先看 HTTP 状态码

模型服务接口：error.code 是固定的错误代码，retryable 说明能不能重试，request_id 用于反馈问题。

模型服务接口

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "余额不足，请充值后再试",
    "request_id": "req_…",
    "retryable": false
  }
}

会员接口：错误说明在 detail 里，多数是带 code 和 message 的对象，少数是一段文字。

会员接口

{
  "detail": {
    "code": "invalid_api_key",
    "message": "API 密钥无效。"
  }
}

商家开放接口、AI 助手接入、平台能力共享和能力网接口：错误说明在 detail 字段，可能是文字或对象；能力网公开接口超限时返回 {"error": "rate_limited", "message": "…"}。

商家开放接口

{
  "detail": "请求太频繁，请稍后再试"
}

示例里的文字只是示意，实际说明以接口返回为准。各接口可能返回的错误见接口文档里每个接口的「返回」部分。