
如何修复团队的 API Key 问题

大多数 Gemini 原型都是同一个开头:从 Google AI Studio 拿一个 API key,粘进 coding agent 开跑。速度是它的优点,问题出在原型有了真实用户、key 却原封不动之后。那时 key 通常不止一个,散在 .env、shell profile 和聊天记录里;配置文件里还内置着一个。文中举了一个例子:一个月正常支出 180 美元的账号,一旦某个 key 进了公开仓库、Slack 频道或移动应用包,自动化爬虫几分钟内就能找到它并跑大负载,第一张账单可能到数万美元。按共享责任模型,客户要为用自己有效凭证产生的用量付费,种子轮公司一个周末烧掉 runway 并不夸张。这篇文章给的办法不是更小心地管 key,而是彻底换成raw API key以外的身份(identity)。配套 repo 有每一步的可运行示例和离线测试。
为什么 raw key 有问题:AI Studio key 是 bearer token,谁拿到谁就能用;它不会自动过期,不绑定机器、人或工作负载,没有自带消费上限。一个人在自己笔记本上用没问题;一旦 key 离开笔记本、多人需要调用,或者月支出超过几百美元、准备接付费客户,就该这周换。动手前先用 repo 里的扫描器找 key,它只报告文件和行号,不会输出 key,并且会以错误码退出,方便接进 CI。
第一步是给每个人身份。团队成员跑 gcloud auth application-default login,浏览器里用工作账号登录,gcloud 在机器上存一个短期凭证,Google Cloud SDK 自动识别,没有需要复制粘贴的东西。这个登录能调 Model Garden 里所有模型,不限于 Gemini;Claude 用 Anthropic SDK 配同一个登录,OpenAI 的开放模型(如 gpt-oss)用 OpenAI SDK 指向 Google Cloud。Claude 这类伙伴模型需要先在 Model Garden 卡片上开启一次。前两步大约五分钟。所有调用落在同一张 Google Cloud 账单上,方便按价格和质量对比。
第二步是给应用身份。应用部署到 Cloud Run、GKE 或 Compute Engine 时,ADC 自动改用所挂服务账号的短期 token,大约一小时过期,代码里没有任何东西可泄露。权限上调用模型只需要 roles/aiplatform.user 这一个角色:给人授这个角色时授给 Google Group 而不是个人,离职就是一次组成员变更;给应用授给服务账号。不授 Editor/Owner,以免被偷的登录或 token 能删资源、改权限、读无关数据。另外三个控制:org 里的项目可以用 vertexai.allowedModels 限制允许调用的模型;repo 里有一键审计脚本,列出所有带 Owner/Editor 的服务账号;Org Policies 可以禁止创建新 key。
剩下必须留的第三方 key(Stripe、Slack、邮件服务等)放进 Secret Manager。测试 key 给开发组读,生产 key 只让应用服务账号读,读取用 –data-file=- 从 stdin 输入,避免进 shell history。轮换 key 就是加一个新版本,不重新部署。迁移完还必须在 AI Studio 的 API keys 页面把离开过笔记本的 key 全部删掉,因为迁移不等于 key 失效。
身份化之后能用的保护包括:spend cap budget(Preview)在预估支出超过设定值时暂停该服务的新请求,并在 50%、80%、100% 发提醒;它按项目和单个服务生效,目前覆盖 Agent Platform、Gemini API、Cloud Run、Cloud Run functions,按预估成本执行且不是即时生效,超出的部分照常计费,服务恢复最多要一小时,所以开发和生产项目要各设一个 cap,并把数字设在你可以承受损失以下。Model Armor 拦截 prompt injection、越狱尝试、恶意 URL 和敏感数据;code execution 让模型生成的 Python 在 Google 管理的沙箱里运行,不接触环境变量、文件和数据库;Security Command Center 加 Cloud Audit Logs 能记录谁在哪一刻改了什么,因为每次调用都来自具名的人或服务账号,日志可以用于企业安全审查。文章最后给了一张 20 分钟的检查清单:跑 ADC 登录、授最小角色、启用伙伴模型、把第三方 key 放进 Secret Manager、设 spend cap、跑扫描器、删全部 AI Studio key。整个过程不会拖慢原型开发。

