配额管理
通过创建可复用的配额规则模板,精确控制 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 生效。