AI Gateway 新增按用户预算,精细管控团队消费上限

Vercel Blog 2026-09-01T06:00:11.730435

AI Gateway 现已支持为团队中的每位成员单独设置美元消费预算。该预算覆盖用户名下所有 API 密钥与应用令牌,一旦超额,请求将被拒绝,直到预算重置或调高。对于控制编码代理等无人值守工作负载的消费,这一功能尤其实用,也能防止个别成员耗尽团队共享预算。

按用户管控消费,防止共享预算被滥用

在 AI Gateway 页面中,管理员可以通过 Budget 的 Users 视图设置两种用户预算:

默认预算与自定义预算均按月重置,也可调整为按天、按周或永不重置。同时支持用量提醒:当消费达到分配额度的 50%、75% 或 100% 时,系统会发送邮件通知。

需要注意的是,用户预算并不会取代 API 密钥、项目或团队预算。一个请求必须同时满足所有适用的预算限制,只要触及其中任意一项阈值,新请求就会被阻止。

密钥归属规则:影响个人预算的计算范围

API 密钥默认归属于创建它的用户账户。如果某个密钥用于生产应用或其他共享工作负载,建议前往 API Keys 页面将其归属改为团队。这样,该密钥的消费不会计入创建者的个人预算。

与用户预算功能一同发布的归属规则有一个需要留意的兼容性变化:在用户预算功能上线之前创建的密钥,为保持向后兼容,将自动归属于团队。如果你希望这些既有密钥的消费计入用户预算范围,需要轮换为新密钥。

通过 CLI 设置用户预算

使用 Vercel CLI 的用户,可通过 CLI 完成预算配置。操作步骤如下:

  1. 运行 vercel upgrade 将 CLI 升级到最新版本——用户预算功能要求 Vercel CLI 59.6.2 或更高版本
  2. 升级后,即可通过 CLI 设置默认或自定义用户预算。

关键要点

查看原文