Workbuddy 怎么给单个 API 密钥设置消费上限,超额后是拦截请求还是只发告警?

Workbuddy 的消费上限由「工作区总额」和「单密钥额度」两层控制,需要在密钥管理与用量设置中同时填写额度值、统计周期、告警阈值和超额动作;多数情况下默认只发出告警,必须手动把超额动作改成硬拦截,才会真正挡住请求。上限按金额计算,不按 token 计算,并且不覆盖订阅套餐内额度和平台赠送额度。

Workbuddy 的 API 密钥消费上限采用「工作区总额 + 单密钥额度」两层结构,入口在密钥管理与用量设置中;配置时必须同时填好额度值、统计周期、告警阈值和超额动作四项,才算配置完成。平台赠送额度和订阅套餐内额度不受这条上限约束,具体字段名称以当前版本界面说明为准。 先设工作区总额、再设单密钥额度,这个顺序不能反。总额度决定整个账号每月最多能花多少钱,是最后一道防线;单密钥额度决定某个项目、某个人最多能花多少钱,是第一道止损线。如果先把几把密钥的额度加起来,却发现超过了总额度,那么超额部分在工作区层面会被直接截断,密钥额度就形同虚设。 超额动作通常有三档:仅通知、降级到低价模型、直接硬拦截,默认值往往是「仅通知」。如果只配置了额度数字,却没有把超额动作改成拦截,那么限额只起到记录作用:用量超过额度后,请求仍然会继续发出,账单也照常累计。想让限额真正具有约束力,就需要把生产密钥设为硬拦截,把测试密钥设为通知或降级。 额度要用金额来设置,不要用 token 数来设置,因为同一笔预算在不同模型上能买到的 token 数量差别很大。按 token 限额时,一旦切换模型,实际支出就会和预期偏离一个数量级;按金额限额时,跨模型、跨供应商的支出才是可比的,换算与统计由平台在计费层完成。 额度检查发生在请求发起之前,它不能中断已经在运行的流式请求或长任务。这就意味着,单次请求超出上限的最后一笔仍会跑完并计费,因此实际支出可能略微超出设定值。如果对预算要求严格,就需要把额度设得比心理上限低一档,用差额来承接这一笔穿透。 用量聚合存在延迟,额度统计并不是实时的,突发并发会在这段延迟窗口里冲过去。常见的情况是:多个任务同时发起,每笔请求在检查时都判断为「未超额」,合起来却已经越过上限。解决办法是,把工作区总额按 10% 至 20% 预留缓冲,同时把单密钥的告警阈值调低,让告警先于额度消耗完之前到达。 一人一密钥、按环境分密钥,是让限额真正可用的前提。开发、测试、生产各用一把独立密钥,各自设置额度;出问题时能立刻定位到人或者项目,吊销也不会影响其他业务。多人共用一把密钥时,额度虽然照样生效,但超额之后无法归因,只能整体停用,造成的损失往往比省下的管理成本更大。 告警阈值建议设两档,比如 70% 和 90%,并且要明确告警之后做什么。告警本身不是限额,它只是给负责人留出决策时间:提额、切换到备用密钥,或者暂停非关键任务。只依赖告警而不设拦截的团队,通常是在账单出来之后才发现问题,这时候支出已经发生。 批量任务和长时任务要单独分配一把密钥,并设置更低的额度。这类任务的特点是并发高、单次消耗大、失败后容易重试,如果和其他业务共用一个额度,一次异常重试就可能占满整个月的预算。给它们单独设额度,相当于将实验性流量与稳定业务隔开。 配置完成后,要用小额请求做一次压测,确认拦截确实会生效。做法是临时把某把测试密钥的额度调到很小,然后发起请求,观察返回的是额度不足的提示,还是照常返回结果。很多配置问题就出现在这一步:额度填了但没有保存,超额动作还是默认的通知档,统计周期选了自然月但业务按周结算。 有几类调用不受这条上限约束,需要单独管理:绕过平台直连模型供应商的请求、套餐内已包含的额度、以及平台赠送的测试金。这些消耗不走同一套计费与检查逻辑,把它们的账单拿来做对比会得到错误结论。凡是需要管控的部分,都应尽量收敛到平台统一发起的调用上。 最后,额度不是设完就可以不管,应该按月复盘一次用量曲线。看哪把密钥接近上限、哪类任务成本最高、告警触发过几次;再据此调整额度值与阈值。消费上限是一种止损机制,真正控制成本依靠的是额度、告警、密钥隔离和定期复盘这套组合,单个数字本身做不到。