Skip to content
EASYJEV

错误与状态码

EasyJev 返回的全部状态码:带 request_id 的统一错误 JSON 结构、完整错误码表(400/401/402/403/404/413/422/429/502)、重试建议与上游透传语义。

统一错误结构

网关自身产生的失败(鉴权、额度、限流、上游耗尽……)在 /v1/* 路径上都返回这个 JSON 错误体。例外是上游校验错误——原样透传(见 systemone 页)。

JSON · error envelope
{
  "error": {
    "message": "Balance is not enough to make this call",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  },
  "request_id": "8f14e45fceea167a5a36dedd4bea2543"
}

状态码总表

HTTPtypecode含义 / 处理
400invalid_request_error上游透传上游拒绝请求体。按上游消息排查;不计费。
401authentication_errorinvalid_api_keyBearer 密钥缺失/错误。检查 sk- 值;被停用的 key 也走这里。
402insufficient_quotainsufficient_quota余额为零/负。充值后重试。
403authentication_erroraccount_suspended / key_disabled账号或密钥被停用——联系支持。
404invalid_request_errormodel_not_found模型不在售卖清单(或拼写错误)。用 GET /v1/models 查有效名。
413invalid_request_errorpayload_too_large / media_too_large请求超大小限制——缩小请求体或拆分资产。
422invalid_request_errorbad_request(网关)/ 上游透传缺 model/state/questions,或上游 schema 拒绝。
429rate_limit_errorrate_limit_exceeded按 key 的 RPM/TPM 触顶。退避重试(限流窗口一分钟内滚动重置)。
502api_errorupstream_failed故障转移后全部「渠道+key」尝试失败。可退避重试;持续出现请携 request_id 联系支持。

重试建议

RETRY

可安全重试:429(先退避——滑动窗口一分钟内释放容量)与 502(故障转移已耗尽,上游瞬时故障常见)。不要盲目重试 400/401/402/403/404/413/422——必须先修正请求本身。每次重试都带新的 request_id,对账不受影响。