鉴权与访问限制错误

本页汇总常见的 403 与 429 错误的错误信息、触发原因与排查方向。涉及具体限流维度（RPM / TPM / Concurrency）的原理与配额规划，请参考限流与配额。

403 Forbidden — IP 被限制

{
  "error": {
    "message": "ip in black list",
    "type": "access_denied_error",
    "code": 403
  }
}

字段	内容
现象描述	接口返回 403 状态码，错误提示包含 `ip in black list`。
触发原因	通常由于使用了错误的 API Key 并在短时间内进行高频/循环请求，系统安全策略检测到异常流量后触发 IP 临时封禁。
影响范围	当前发起请求的 IP 地址。
恢复时间	属于临时限制，通常在停止错误请求后的 5–15 分钟内自动解除。

解决方案：

{
  "error": {
    "message": "access denied for invalid user",
    "type": "access_denied_error"
  }
}

触发原因：账号处于欠费保护期，无法使用 API 服务。请充值或确认账户余额后重试。

{
  "error": {
    "message": "invalid user v2",
    "type": "access_denied_error"
  }
}

触发原因：短时间内出现异常高频请求，触发风控策略导致账号被封禁。请联系技术支持团队并提供业务调用说明，以便进行解封审核。

限流错误的 type 为 rate_limit_exceeded_error，message 会指明触发的限流维度（RPS / RPM / TPM），例如：

{
  "error": {
    "message": "rate limit reached for TPM",
    "type": "rate_limit_exceeded_error"
  }
}

触发原因为请求超出对应的限流配额。目前限制随资源调度策略动态优化，如需较高资源保障，请联系技术支持团队。各限流维度的含义与生效范围详见限流与配额；TPM 预估计算方式与优化建议详见 TPM 是如何计算的。