错误码

平台通用错误码集中在本页；资源相关错误码保留在对应的 Reference 页面。

通用错误码

HTTP	通用错误码 / 类型	说明
400	`invalid_request_error`	请求参数或请求结构错误。
400	`missing_required_field`	缺少必填字段。
400	`invalid_field_value`	字段值不合法。
400	`invalid_range`	字段值超出允许范围。
400	`unsupported_response_format`	不支持的输出格式。
400	`unsupported_feature_for_model`	当前模型不支持该能力。
400	`invalid_url`	URL 格式不合法。
400 / 403	`url_not_allowed`	URL 被安全规则拒绝。
401	`authentication_error`	鉴权失败；框架支持该状态码。
403	`permission_error`	API Key 缺失或无效、权限不足或安全策略拦截；当前网关可能返回 403。
402	`billing_error` / `insufficient_credits`	计费失败或余额不足。
429	`rate_limit_error` / `rate_limit_exceeded`	请求频率超限。
429	`concurrency_limit_exceeded`	并发超限。
409	`conflict_error`	资源冲突。
404	`not_found_error`	通用资源不存在类型；具体资源 code 留在接口页。
403	`safety_guardrail_blocked`	被安全策略拦截。
500 / 502 / 503 / 504	`internal` / `upstream` / `service` / `timeout`	服务端、上游、服务不可用或超时。

{
  "error": {
    "message": "错误说明",
    "type": "错误类型",
    "param": null,
    "code": "错误码"
  }
}

通用同步 HTTP 错误遵循上述结构；具体 error.code 及参数以对应接口说明和实际响应为准。