EasyXAI 文档
API 接入

错误处理

HTTP 状态码

同时检查 HTTP 状态码与响应体。错误响应使用请求接口对应的协议格式。

状态码含义处理方式
400请求格式、参数有误,或内容被拒绝。检查 JSON、模型和参数取值。
401API Key 缺失或无效。检查鉴权请求头和 Key。
403Key 已停用,或没有模型调用权限。检查 Key 状态和模型权限。
404模型或可用通路不存在。检查模型名称与请求路径。
429请求频率或资源限制。降低并发,延迟后重试。
500 / 503服务错误或暂时不可用。稍后重试。
504请求超时。检查客户端超时设置,稍后重试。

API Key 限额、有效期和 IP 白名单被拒绝时,响应里的 code(或响应头 x-easyx-error-code)是下面这些值。日、周、月额度到下一个周期会重新计算;累计额度不会自动恢复。

code状态码含义
ERR_API_KEY_EXPIRED403这把 Key 已过有效期。延长有效期后再调用。
ERR_API_KEY_IP_NOT_ALLOWED403调用方 IP 不在白名单内,或无法识别调用方 IP。
ERR_KEY_DAILY_CREDIT_EXHAUSTED429每日额度已用尽。
ERR_KEY_WEEKLY_CREDIT_EXHAUSTED429每周额度已用尽。按自然周计算。
ERR_KEY_MONTHLY_CREDIT_EXHAUSTED429每月额度已用尽。
ERR_KEY_TOTAL_CREDIT_EXHAUSTED429累计额度已用尽。需要提高上限后才能继续。
ERR_KEY_CREDIT_NOT_READY503额度暂时算不出来。稍后重试。

OpenAI

{
  "error": {
    "message": "model is required",
    "type": "router_error",
    "code": "ERR_MODEL_REQUIRED"
  }
}

Anthropic

{
  "type": "error",
  "error": {
    "type": "router_error",
    "message": "model is required"
  }
}

Gemini

{
  "error": {
    "code": 400,
    "message": "model is required",
    "status": "ERROR"
  }
}

火山方舟

{
  "error": {
    "code": "ERR_MODEL_REQUIRED",
    "message": "model is required"
  }
}