EasyAPI
错误码与状态码

错误处理摘要

EasyAPI 使用 HTTP 状态码表示错误类别，并可在响应体的 error 对象中返回 message、type 和 code。客户端应根据状态码决定修正请求、检查密钥、退避重试或联系支持。

关键事实

  • 400 表示请求参数无效或缺少必填字段。
  • 401 表示未提供或使用了无效的 API Key。
  • 429 表示请求频率或配额超限，500 表示服务端内部错误。

错误码 FAQ

遇到 429 应该怎么处理？
降低请求频率并实施指数退避，随后检查配额和用量；不要立即高频重复相同请求。
遇到 500 应该怎么处理？
记录响应和 request id（若有），稍后重试；问题持续时将不含密钥的错误信息提供给支持人员。

错误码与状态码

HTTP 状态码与业务错误码对照。

错误码与状态码

API 错误以 HTTP 状态码表示类别，响应体中可包含 error 对象（含 message、type、code 等字段，与 OpenAI 风格兼容）。

常见错误

HTTP 状态码错误码描述
400invalid_request_error请求参数无效或缺失必填字段
401invalid_api_key未提供或无效的 API Key
429rate_limit_exceeded请求频率或配额超限
500server_error服务端内部错误，请稍后重试

错误响应示例

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

处理建议

  • 401：检查 Authorization 头与 Key 是否有效
  • 429：实施指数退避重试，或升级配额
  • 500：记录 request id（若有）并联系支持