切换深色模式
5h / 7d / 30d 滚动额度
5h5 小时
短周期,用于控制突发消耗
7d7 天
中周期,限制一周内累计用量
30d30 天
长周期,限制一个完整周期的累计用量
窗口从权益首次实际使用开始记录;到期后,下一次请求会进入新的同长度窗口。具体重置时间以控制台显示为准。
如何计算
每个已配置窗口分别累计统一的美元计价用量:
5h:从窗口开始起累计 5 小时。7d:从窗口开始起累计 7×24 小时。30d:从窗口开始起累计 30×24 小时。
这三个窗口同时生效。即使 30 天额度还有剩余,5 小时额度耗尽也会暂时拒绝请求。
窗口何时开始
新权益创建时,滚动窗口可能尚未激活。窗口从首次实际产生用量的周期开始记录,而不是按每个自然日、周一或月初统一重置。
这里的“滚动”表示从当前窗口起点计算固定时长,不是每次请求都向前回看并移动起点。窗口到期后,下一次使用会进入新的周期;页面显示会清除过期窗口的旧用量。
重置时间
控制台会显示每个窗口的开始时间、已用、剩余和预计重置时间。若订阅到期早于窗口结束,显示的有效结束时间不会晚于订阅到期时间。
不要自行用本地时区推算。系统时间错误、页面缓存或旧会话可能让倒计时看起来不一致,刷新我的订阅后以服务端时间为准。
无限额与零额度
- 页面显示“无限额”通常表示该窗口没有配置限制。
- 已配置为零不等于无限额,会阻止使用。
- 套餐仍可能受其他窗口、Key 额度、并发、RPM 和上游限流约束。
续费对窗口的影响
有效套餐续费时:
- 有效期从当前到期时间继续延长。
- 新订单的套餐额度快照可以更新当前三档限额。
- 已累计用量和仍在运行的窗口不会因为普通有效期续费而清零。
已过期套餐重新激活时,会从当前时间开始新的有效期,并重置旧的滚动用量周期。
窗口耗尽
常见错误为 429 USAGE_LIMIT_EXCEEDED,正文可能包含 FIVE_HOUR_LIMIT_EXCEEDED、SEVEN_DAY_LIMIT_EXCEEDED 或 THIRTY_DAY_LIMIT_EXCEEDED。查看具体重置时间后等待,或改用另一个具有可用权益的 Key/分组;不要高频重试。
