AI Gateway 新增按用户预算,精细管控团队消费上限
AI Gateway 现已支持为团队中的每位成员单独设置美元消费预算。该预算覆盖用户名下所有 API 密钥与应用令牌,一旦超额,请求将被拒绝,直到预算重置或调高。对于控制编码代理等无人值守工作负载的消费,这一功能尤其实用,也能防止个别成员耗尽团队共享预算。
按用户管控消费,防止共享预算被滥用
在 AI Gateway 页面中,管理员可以通过 Budget 的 Users 视图设置两种用户预算:
- 默认预算:为所有没有自定义预算的用户(含后续新加入成员)单独设定消费上限。每个人拥有独立额度,而不是全团队共享一个总额度。
- 自定义预算:仅针对特定用户,并覆盖默认预算。移除自定义预算后,该用户将自动回落到默认预算规则。
默认预算与自定义预算均按月重置,也可调整为按天、按周或永不重置。同时支持用量提醒:当消费达到分配额度的 50%、75% 或 100% 时,系统会发送邮件通知。
需要注意的是,用户预算并不会取代 API 密钥、项目或团队预算。一个请求必须同时满足所有适用的预算限制,只要触及其中任意一项阈值,新请求就会被阻止。
密钥归属规则:影响个人预算的计算范围
API 密钥默认归属于创建它的用户账户。如果某个密钥用于生产应用或其他共享工作负载,建议前往 API Keys 页面将其归属改为团队。这样,该密钥的消费不会计入创建者的个人预算。
与用户预算功能一同发布的归属规则有一个需要留意的兼容性变化:在用户预算功能上线之前创建的密钥,为保持向后兼容,将自动归属于团队。如果你希望这些既有密钥的消费计入用户预算范围,需要轮换为新密钥。
通过 CLI 设置用户预算
使用 Vercel CLI 的用户,可通过 CLI 完成预算配置。操作步骤如下:
- 运行
vercel upgrade将 CLI 升级到最新版本——用户预算功能要求 Vercel CLI 59.6.2 或更高版本。 - 升级后,即可通过 CLI 设置默认或自定义用户预算。