ToRouter 文档API 密钥
配额、限流与过期
单密钥设定 USD 花费上限、滑动窗口限流，以及 N 天后自动失效。
每个 ToRouter 密钥有三类独立限制，并与套餐侧的额度规则取交集——更严格的那条先生效。
花费上限（USD）
为这把密钥设置美元花费的硬上限。
- 不设单独上限：在控制台保持默认或填 0，表示沿用套餐侧的额度，不为这把密钥单独封顶。
- 设为正数：累计消费达到该金额后，新请求会被拒绝。
用尽时接口会返回 402（余额或配额不足）。请到控制台充值，或调高密钥/套餐相关额度。
请求频率（滑动窗口）
在三个相互独立的滑动窗口里分别计数请求次数——三个窗口都未超限才会放行。
- 约 5 小时窗口：抑制短时间突发流量。
- 约 24 小时窗口：适合控制「单日」调用节奏。
- 约 7 天窗口：适合共享密钥的周度总预算。
在对应窗口填 0 表示关闭该档限制。任一窗口触发上限会返回 429，处理思路见 被限流。
自动失效
可设置「自创建起多少天后自动停用」：
- 0 表示永不过期（默认）。
- 30 表示约 30 天后失效。
过期后密钥返回 401。需要继续使用请新建密钥（参见 轮换）。
限额在调用上游之前判断，被拦截的请求不计费。
修改限额
API 密钥 → 点击密钥行 → 编辑 → 保存。下一次请求即生效。