指南

在达到限制之前监控密钥用量

因为一个请求刚刚被拒绝才发现自己快到每日限制,是最没用的发现方式。每个响应本来就携带了能让您提前看到这一点的数字。

需要关注的响应头

X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Z

X-Quota-Free-Remaining 逐渐缩小到零,是每日免费配额最明确的早期信号。X-Credits-Remaining 则告诉您在用完免费配额、开始按每次请求 €0.0001 消耗预付额度之后,还剩多少余量。

设置您自己的告警阈值

与其等到出现 429,不如在 X-Quota-Free-Remaining 降到您设定的阈值(例如 X-Quota-Limit 的 10%)以下时记录日志或发出告警,这样就有时间应对,无论是放慢批量任务、充值额度,还是干脆预期在 X-Quota-Reset 之前会有一段空闲期。

同时关注密钥的 IP 名额

X-Key-IPs-Used 和 X-Key-IPs-Limit 记录在滚动 IP 名额配额下有多少个不同的来源地址使用过某个密钥。如果一个密钥突然被比预期更多的地址使用,并逐渐接近上限,这本身就值得调查,与请求量无关,因为这可能说明密钥被分享的范围超出了预期。

搭建一个简单的仪表板

写一个小脚本,在部分请求上(如果用量够小,也可以在每个请求上)记录这些响应头,就能得到随时间变化的用量趋势,而无需单独的监控调用,因为这些数字就在您原本就会发出的请求的响应中。把 X-Quota-Used 按一天或一周的时间绘制出来,能呈现出单次快照永远看不到的用量模式。

在碰壁之前采取行动

一旦您发现用量持续接近上限,接下来的两条路与任何时候都可选择的两种方案相同:为偶尔的超出添加预付额度,或者如果您持续超出免费配额,改用每月 €50 的 Unlimited 密钥。无论哪个决定,提前冷静地做,都比在线上出现 429 阻断真实流量时再应对要容易。

把配额响应头当作日常遥测数据来读,而不只是在请求失败时才去检查,就能把硬性限制变成可管理的趋势。当前的配额和额度选项见价格页面,完整的响应头定义见速率限制文档