消费限制
为每个 Inference API Key 设置消费上限:RPM 限制、积分预算、none/daily/weekly/monthly 四种重置周期与各自的 UTC 窗口,以及触发 429 时会返回哪些字段。
每个 Inference Key 有两类独立保护:
- RPM:限制每分钟请求数。
- 消费上限:限制当前周期内可以使用的 Credits。
spend_reset 接受小写取值 none、daily、weekly、monthly,传入其他值会回落为 daily。
spend_reset | 预算周期 |
|---|---|
none | 不重置——上限对这个 Key 历史累计消费生效。 |
daily | 每天 UTC 00:00 重置。 |
weekly | 每周一 UTC 00:00 重置。 |
monthly | 每月 1 日 UTC 00:00 重置。 |
spend_reset 决定的是预算什么时候清零,不是有没有上限。要让一个 Key 完全不受消费上限约束,把 spend_limit 设为 0:这会关闭用户侧消费保护,但账户「可用于 Public API」的余额仍然是最终硬限制。
rpm_limit 取值 1–300,默认 60。非 0 的 spend_limit 取值 1–100,000 积分,默认 300。
Settings → API Keys 页面只提供每日积分上限,提交时固定发送 spend_reset: "daily"。需要其他重置周期时,请通过 Management API 创建 Key。
请求前会发生什么
GLM5 会先估算请求成本,在 Key Budget 中原子预留额度,再预留账户 Credits。上游完成后,根据真实 Token 使用量同时结算两处预留。如果请求在成功完成前失败,预留会被释放,失败请求不会保留完整的预估扣费。
达到上限时
API 返回 HTTP 429,错误码为 api_key_spend_limit_exceeded,并返回当前周期、所需 Credits、剩余额度与适用的重置时间。
在 Settings → API Keys 修改限制。需要立即、可恢复地停止某个客户端时使用 Disable;只有确定该凭证永远不应再次工作时才使用 Revoke。