错误

HTTP	意义	建议采取的行动
400	无效请求	正确的 JSON 和必填字段
401	无效、冻结或撤销的密钥	旋转或解冻密钥
第402章	账户余额不足或达到密钥使用限制	添加资金或重置/增加关键限额
第403章	模型对于被 API 白名单拒绝的密钥或源 IP 不可用	更新关键权限或使用允许的源 IP
404	未知端点、模型或异步请求	检查标识符和路径
第413章	请求太大	减少上下文大小
第429章	超出 RPM 或并发数	荣誉 Retry-After
500	网关错误	重试并检查日志
502/503/504	上行不可用或超时	使用指数退避重试

需要付款

公司/帐户余额不足返回 HTTP 402 Payment Required 在 OpenAI 兼容的信封中：

{
  "error": {
    "message": "Insufficient account balance.",
    "type": "payment_required",
    "code": "insufficient_balance"
  }
}

请求历史记录中记录了相同的稳定原因/代码。一个 402 请求在提供商执行之前被拒绝，并且在资金或适用的支出限制得到纠正之前不应自动重试。

IP 白名单拒绝

当经过身份验证的 API 密钥有效但源地址位于有效的个人或企业组织 API 许可名单之外时，Model Gate 将在上游执行之前拒绝请求。 OpenAI 兼容响应使用 HTTP 403 带代码 ip_not_allowed。 Anthropic 兼容响应将 Anthropic 错误信封与 HTTP 结合使用 403 和 authentication_error。不要从同一个不允许的来源重试；更改配置的白名单或从允许的地址发送请求。

重试 429 后 Retry-After。重试 500, 502, 503， 和 504 最多 3 次，具有 1/2/4 秒退避。不要自动重试验证、身份验证、平衡或未找到错误。

使用来自以下位置的请求公共 ID： X-Request-ID 将响应与 请求日志。