错误处理 - 模型 API

接口使用标准 HTTP 状态码，并在响应体中返回错误信息。

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

HTTP 状态码	场景	是否重试
`400`	参数或请求体不合法	修正请求后再发送
`401`	API Key 无效	更换有效密钥
`403`	模型或分组权限不足	调整权限或模型
`404`	接口、模型或任务不存在	检查地址和标识符
`429`	速率限制或额度不足	根据错误信息退避或补充额度
`500`	服务内部异常	使用指数退避重试
`502` / `503`	上游暂时不可用	切换模型或指数退避重试

重试策略

仅对暂时性错误执行有限次数的指数退避，例如等待 1s、2s、4s。对 400、401、403 等确定性错误直接返回业务调用方，避免形成重试风暴。