EasyRouterEasyRouter
使用指南API 文档接入 Agent 工具

配额管理

通过创建可复用的配额规则模板,精确控制 API Key 和账户的消费上限。每条规则可定义额度限制和时间窗口,绑定到单个 Key 或设为账户默认。

配额管理


使用场景

  • 防止超额消费 — 为 Key 设置每日/每周/每月积分上限,额度用完后当前周期内自动拒绝请求。
  • 环境隔离 — 给开发调试用的 Key 设低额度,生产 Key 保持无限制,避免误操作消耗。
  • 限制使用时段 — 只允许工作时间调用 API(如周一至周五 08:00–20:00),防止脚本夜间异常跑量。

规则生效逻辑

规则遵循明确的优先级链:

API Key 绑定的规则(优先) → 账户默认规则(次之) → 无限制
  • API Key 设置了独立规则 → 使用该规则。
  • API Key 未设置 → 继承账户默认规则。
  • 两者都未设置 → 该 Key 无任何消费和时间限制。

创建规则

点击 + 创建配额规则 打开编辑面板。

创建配额规则

基本信息

  • 规则名称 — 起一个好记的名字,例如"开发 Key 每日上限"。
  • 描述 — 可选,补充说明规则适用的场景。
  • 启用规则 — 开关控制。停用后规则保留,但不会被新绑定时推荐。

额度限制

  • 启用额度限制 — 开启后设置消费上限。达到上限后,当前周期剩余时间内请求被拒绝。
  • 额度周期 — 选择每日每周每月。每个周期开始时额度清零重置。
  • 额度上限 — 周期内允许的最大积分消耗。输入框旁标注单位为积分

时间窗口

  • 启用时间窗口 — 开启后限制规则生效的时段。时段外请求会被拦截。
  • 时区 — 选择规则绑定的时区(如 UTC+8)。
  • 允许星期 — 勾选允许调用 API 的星期。通常工作时间勾选周一至周五。
  • 允许时段 — 设置时间段,格式为 HH:MM-HH:MM(如 08:00-20:00)。

规则预览

编辑面板底部的预览区会以纯文本形式展示规则生效后的实际效果,提交前请确认无误。


绑定规则的位置

绑定到 API Key

进入 API Key 管理,找到目标 Key,点击行内的绑定规则。在下拉菜单中选择一条规则,或选择继承账户默认规则沿用账户级设置。

设置账户默认规则

进入 个人设置,找到默认配额规则卡片,在下拉框中选择一条规则作为账户全局默认。未单独配置的 API Key 将自动继承此规则。

默认配额规则


管理已有规则

规则列表展示所有已创建的模板,每行显示:

列名说明
规则名称创建时设定的名称
额度限制周期和积分上限(如"每日积分上限 50.00")
时间窗口允许的星期和时段,附带时区
状态启用(绿色)或停用(灰色)
被引用数当前有多少 API Key 绑定了此规则
操作编辑修改规则,启用/停用切换状态

已有 Key 引用的规则仍可修改,修改后立即对所有绑定 Key 生效。