限额

每把密钥的请求上限

每把密钥独立计数，24 小时滚动窗口。档位在创建时按勾选的权限确定：

窗口从这把密钥的第一次请求起算；满 24 小时后计数归零，重新起算。所有接口的请求都计入，包括失败的和 /api/file/* 的下载。

出图本身按积分计费，限额只防止接口被打爆；只读接口常被轮询，因此上限更高。需要更高限额请联系我们。

超过上限返回 429 rate_limited：

{
  "error": {
    "code": "rate_limited",
    "message": "这把 API 密钥已超过 24 小时内的请求上限，请稍后再试。",
    "request_id": "req_xxxxxxxxxxxxxxxxxxxx"
  }
}

新账号的消耗上限

注册未满 7 天的账号，24 小时内最多消耗 2000 积分，网页和 API 合并计算。超过返回 429 new_user_daily_limit，满 7 天自动解除。这是防刷号的，正常用量碰不到。

建议

• 批量出图：串行或小并发，收到 429 后指数退避（1 分钟、2 分钟、4 分钟……），不要立即重试
• 轮询图片包：常态 60 秒一次，连续几轮没有新记录就退避到 5 分钟。6000 次 / 24 小时足够 60 秒轮询加重试
• 多个系统接入：各用一把密钥，限额互不占用，泄露也只撤一把

早期密钥

在限额分档上线前创建的密钥沿用当时的默认值 10 次 / 24 小时。需要更高限额时重新创建一把。