怎么给 API Key 设置每日/每月预算上限？

给 API Key 设预算上限，目的是防止某一个 Key 因为程序 bug、被滥用或泄露而把账户余额耗光。在 EasyAPI 上，这个设置在控制台的令牌管理里完成，针对单个令牌（即 API Key）生效。

EasyAPI 的令牌有两种互相独立的限额方式：独立额度是这个 Key 一共能花多少，周期预算是这个 Key 每天或每月能花多少。本文说明的界面选项以控制台实际显示为准。

关键要点

• 周期预算按 Key 设置，周期可选「每日」或「每月」。
• 周期内消费达到预算上限后，该 Key 的请求会被自动拒绝，下个周期自动恢复。
• 周期按自然日、自然月统计，时区为 UTC+8。
• 周期预算与令牌的总额度互不影响，可以同时设置。
• 账户钱包余额是所有 Key 共同的硬约束，余额不足时即使预算未用完也无法调用。

设置步骤

1. 登录 EasyAPI 控制台，进入「令牌管理」。
2. 点击「添加令牌」创建新 Key，或在列表中点击已有令牌的「编辑」。
3. 在额度设置区域打开「周期预算」开关。
4. 填写预算上限（需大于 0），金额单位以表单标注为准。
5. 在「结算周期」中选择「每日」或「每月」。
6. 提交保存。修改会立即生效，API Key 本身不会改变。

设置后，令牌列表中会显示该 Key 本周期的已用金额与预算上限，可以直接看到用量进度。

三种限制的区别

令牌的配额模式有两种：「共享账户额度」表示这个 Key 直接使用账户余额，不单独设上限；「独立额度」表示给这个 Key 单独分配一个总量上限。

怎么搭配取决于你的目的：

• 防止单日异常消耗（如循环调用的 bug）：设每日预算。
• 控制某个项目的月度成本：设每月预算。
• 给外包、测试或临时用途一笔固定额度：设独立额度，并配合过期时间。
• 同时要总量和节奏两层控制：独立额度加周期预算一起用。

配合其他令牌设置

令牌管理里还有几项设置，适合与预算一起使用：

一个实用的做法是按环境或项目拆分 Key，例如「生产环境」「本地测试」「数据批处理」各一个，分别设置预算和可用模型。这样某个 Key 触顶或出问题时，不会影响其他业务，调用记录里也能按令牌名称筛选出各自的花费。

需要注意的地方

• 预算拦截发生在周期用量达到上限之后。 不建议把预算当成精确到分的闸门，设置时留出一点余量，周期内的实际消费以令牌列表和调用记录显示的数字为准。
• 触顶后的报错需要程序处理。 请求被拒绝时，程序应识别这类错误并停止重试，而不是不断退避重发。报错排查见 调用大模型 API 返回 401 / 429 / 5xx 分别该怎么排查。
• 预算不等于告警。 它的作用是到上限后拒绝请求。本文没有涉及用量提醒功能，想提前掌握用量，可以定期查看令牌列表或调用记录。
• 周期按 UTC+8 的自然日和自然月计算。 每日预算在北京时间零点重置，而不是从创建时刻起算 24 小时。
• 界面可能调整。 字段名称与位置以控制台实际显示为准。

常见问题

每日预算用完后，当天还能继续调用吗？

用同一个 Key 不能，请求会被拒绝，到下一个自然日自动恢复。如果确实需要继续，可以在令牌管理里调高这个 Key 的预算上限，或换用其他 Key。

周期预算和独立额度有什么区别？

周期预算限制的是每天或每月的消费，到期自动重置；独立额度限制的是这个 Key 的累计总消费，用完就失效，不会自动恢复。两者互不影响，可以同时设置。

设置预算后需要更换 API Key 吗？

不需要。编辑令牌只改配置，Key 本身不变，已经部署的程序不用改动。

能给整个账户设每月预算吗？

本文介绍的周期预算是针对单个 Key 的。想控制整个账户的支出，直接的办法是控制充值金额，因为账户余额是所有 Key 的共同上限。

小结

在 EasyAPI 的令牌管理里打开「周期预算」，选择每日或每月并填写上限，就能为单个 API Key 设定周期消费上限；再配合独立额度、模型限制和 IP 白名单，可以把单个 Key 的风险控制在可接受范围内。计费细节见 大模型 API 按量计费是怎么算的，控制台入口在 EasyAPI 主站。