错误处理

接口失败时会返回 HTTP 状态码和 JSON 错误体：

{
  "error": {
    "message": "Invalid authentication credentials",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

状态码	含义	建议
400	请求参数错误	根据 message 修正请求体
401	Key 无效或缺少认证	检查 Bearer Token 和 Key 状态
403	没有接口权限	联系管理员检查令牌权限
404	路径或模型不存在	检查 Base URL 和模型 ID
409	请求状态冲突	重新读取资源后再操作
429	触发限流或余额限制	退避重试，避免立即重发
500	服务内部错误	使用请求 ID 联系管理员
502/503	上游或服务暂不可用	指数退避后重试

对于 429、502 和 503，建议使用带上限的指数退避；对于 400、401 和 403，不要重复发送完全相同的请求。