cocodot
← 返回教程
国内卡付不了海外 AI?cocodot 一张卡 + 一个 Key 搞定
安全实践更新于 2026-10

API key 泄露了怎么办?被盗刷怎么止损、怎么自查、以后怎么防(2026)

API key 泄露后第一步是吊销,不是删提交、不是把仓库设成私有。按止损顺序处理、用三条标准自查有没有泄露,再用分 key 和预付余额把下一次的损失封在最小范围。

一句话结论:API key 一旦泄露,第一步是去服务商后台吊销它,不是删提交、不是把仓库设成私有。按量计费的 key 本身就是付款凭证:谁拿到它,谁就能用你的余额或你绑定的付款方式调用模型,而扫描公开代码的程序发现新 key 往往比你自己快。止损顺序是:吊销 → 换新 key 并更新到所有用到它的地方 → 按时间段核对用量,划出损失范围 → 清理泄露源 → 补上防护。日常防护有四层:key 只放服务端和环境变量;按用途分 key,让一次泄露只断一条线;能设过期就设过期;降低资金暴露(小额、按需充值,另设应用侧预算护栏)。排错时也别把 key 打印到终端或日志里 —— 判断程序有没有读到 key,看它是否为空、长度对不对就够了。

1. 泄露的后果为什么来得这么快

按量计费的 API key 不是一个普通密码,它本身就是付款凭证:请求里带着它,服务商就从这把 key 所属的账户扣费,不需要你的登录密码,也不需要你的确认。有人专门用程序持续扫描公开的代码仓库、公开的软件包和网页,寻找形如 key 的字符串;拿到之后会尽快用掉,因为他们知道你迟早会吊销。所以一次泄露的损失只取决于两件事:从泄露到吊销隔了多久,以及这把 key 背后最多能花掉多少钱。前者靠发现得早,后者靠事前设好天花板。风险最高的是后付费、绑定信用卡自动扣款的账户:没有余额这道墙,损失要等到账单出来或触发服务商的消费上限才会停。

2. key 是从哪几条路漏出去的

① 提交进 Git:.env 没写进 .gitignore、测试脚本里临时写死了 key、配置示例文件里填的是真值。② 打进前端或客户端:浏览器加载的 JS、App 安装包、浏览器插件,任何发到用户设备上的东西都能被看到,混淆只是让人多花几分钟。③ 贴进公开渠道:提问时贴了完整的 curl 命令、截图里带着终端、把含请求头的报错日志原样贴进 issue 或群聊。④ 交给第三方工具:各种要你填 key 的在线工具、插件和共享配置,这把 key 的安全从此取决于对方的安全。前两条可以用工具在提交前拦住,后两条只能靠习惯 —— 所以下面第 7 节既给工具,也给习惯。

3. 为什么「删掉提交」「设成私有」都不算处理

Git 的历史是追加的:你在下一次提交里删掉 key,它仍然躺在之前的提交里,任何 clone 过仓库的人都能翻出来。仓库公开过哪怕几分钟,内容也可能已经被抓取、被 fork、被缓存。把仓库设成私有、甚至删掉仓库,只能挡住以后的人,挡不住已经拿到的人。唯一能让泄露失效的动作,是在服务商后台让这把 key 作废。重写 Git 历史(用 git filter-repo 这类工具)是第二步的事,目的是防止以后的人再捡到;而且要通知所有协作者重新 clone,否则他们本地的旧历史一推,key 又回来了。

没有海外卡也能调大模型:cocodot 的 OpenAI 兼容 API,改 base_url 就能调在售型号。

支付宝 / 微信支付(人民币)、USDT / USDC 充值 · 按 token 计费 · 改 base_url 即可接入

4. 泄露之后的止损顺序(不要颠倒)

① 吊销:在后台把这把 key 作废,越快越好,哪怕你还不确定是否真的泄露。以 Anthropic 的控制台为例,它把「禁用」和「删除」分成两个动作:禁用可以恢复,删除是永久的;怀疑泄露时先禁用就能立刻止血,确认无用再删除。② 换新 key:新建一把,替换所有读它的地方 —— 环境变量、部署平台的密钥设置、CI 配置、同事本地的 .env。③ 划损失范围:按时间段看用量和账单,找出第一笔你不认识的调用,记下时间、金额和涉及的模型。④ 清理源头:重写 Git 历史、删帖、撤截图、下架带 key 的安装包。⑤ 复盘补防护:搞清楚是第 2 节的哪条路漏的,在那条路上加一道拦截。很多人先花一小时清理 Git 历史,那一小时里 key 还在被用,这就是顺序颠倒的代价。如果出现了你不认识的扣费,通过服务商的支持渠道提交异常时间段和 key 名称;能不能退、退多少以服务商的处理为准,别把它当成兜底。

5. 自查:三条标准判断 key 有没有泄露

不需要等到出事才查。三条你自己就能核对的判断标准:① 用量和你的作息对不上 —— 深夜、周末、你明明没跑任务的时段出现调用,或某一天的用量突然翻了几倍,或出现了你从没用过的模型;② 「最近使用时间」不对 —— 一把你以为已经闲置的 key,最近被用过;③ 本地扫描有命中 —— 用 gitleaks、trufflehog 这类开源工具扫一遍仓库的完整历史,而不是只看当前文件,CI 的日志和打包产物也一起扫。有一件事千万别做:把 key 或它的一段粘贴到搜索引擎、在线检测网站里「查查有没有泄露」—— 这一步本身就是一次泄露。任何一条命中,都先吊销,再慢慢查原因。

6. 分 key:让一次泄露只断一条线

只有一把 key 的时候,吊销的代价是所有服务一起断,于是人会犹豫要不要立刻吊销 —— 损失往往就是在这段犹豫里扩大的。按「泄露半径」来分:生产服务一把、CI 和测试一把、每个项目或每个成员各一把,名字写清楚用途。可以参考 Anthropic 官方文档的做法:它把 key 分成个人 key 和服务账号 key,个人 key 跟着人走,人离开组织 key 就失效;共享或自动化的工作负载(CI、生产服务)建议用服务账号的 key。建 key 时还可以选过期时间,预设有 3 小时、1 天、7 天、30 天,也能自定义或选永不过期;过期之后的请求返回 401 authentication_error,而且过期的 key 不能重新启用。这套思路在任何平台都能借用:谁在用、用多久,建 key 的时候就定下来,临时给外包或演示用的 key 用短期限,项目结束就作废。

7. 让 key 不进代码、不进日志:几条能直接抄的做法

key 放在环境变量或部署平台的密钥设置里,代码只读变量名;.env 写进 .gitignore,仓库里只放不含真值的 .env.example;装一个提交前扫描,把带 key 的提交挡在本地。前端永远不放 key:改成前端调你自己的后端,由后端带着 key 去请求模型,后端还能顺便做限流和鉴权。排错时最容易顺手泄露:判断程序有没有读到 key,看它是否为空、长度对不对就够了,不要 echo 或 print 出来,也不要把带 key 的完整命令贴给别人;需要别人帮忙时,把 key 换成 YOUR_KEY 这样的占位符。日志框架如果会记录请求头,记得把 Authorization 和 x-api-key 这两个字段过滤掉。

只检查有没有读到 key,不打印内容;.gitignore 只放行示例文件
# .gitignore:真值文件全部忽略,只放行不含真值的示例
.env
.env.*
!.env.example

# 只判断变量是否为空、长度多少,不输出 key 本身
if [ -n "$OPENAI_API_KEY" ]; then
  printf '已读到,长度 %s\n' "$(printf '%s' "$OPENAI_API_KEY" | wc -c)"
else
  echo '没读到 OPENAI_API_KEY'
fi

# 提交前 / 定期:用 gitleaks、trufflehog 这类工具扫描完整 Git 历史
# 具体命令以各工具官方文档为准

8. 在 cocodot 上怎么管 key

cocodot 的 key 在生成时只显示一次,平台只存哈希、无法找回 —— 所以丢了就吊销旧的、重新生成一把,不存在「找回」这回事;生成后请直接存进你的环境变量或密钥管理工具。生成时可以填一个备注名区分用途(比如 proj-a、ci、staging),key 列表里能看到每把 key 的前缀、创建日期和最近使用时间,正好用来做第 5 节的自查:一把闲置的 key 出现了最近使用时间,就该吊销。吊销后这把 key 立即失效,正在用它的程序会断,所以先按第 6 节分好 key,吊销时就不会误伤别的服务。余额是预付的,按 token 计费,账户没有可用额度时新请求会被拒绝,但进行中的请求仍可能计费;小额充值能降低资金暴露,不能代替应用侧的步数、并发与预算限制。换了新 key 还报 401 的排查见 /hub/api-401-invalid-api-key-fix,agent 循环的预算护栏见 /hub/agent-api-cost-runaway。

症状 → 多半的原因 → 先做什么

症状多半的原因先做什么
你没跑任务的时段出现调用,或某天用量突然翻几倍key 已经在别人手里立刻吊销,再按时间段核对用量
公开仓库里提交过 .env 或带 key 的配置Git 历史里仍有这把 key先吊销,再重写历史;只删文件不算处理
前端代码或客户端安装包里写了 key打开开发者工具或解包就能拿到吊销后改成前端调你自己的后端
截图、issue、群聊里贴过带 key 的命令公开内容会被抓取和转发吊销;以后排错一律用占位符
换了新 key,程序还报 401某处仍在读旧 key 或旧配置逐个检查环境变量、.env、部署平台和 CI 的密钥设置
只有一把 key,吊销后所有服务一起断没有按用途分 key按用途拆开,下次只断一条线

常见问题

key 泄露被盗刷的钱能退吗?

以服务商的处理为准,不要指望。已经发生的调用对服务商来说是真实的算力消耗,能否退款、退多少各家规则不同。你能做的是尽快吊销,整理出异常调用的时间段和 key 名称提交给支持渠道。真正能控制损失的在事前:分 key、预付小额、能设过期就设。

把仓库删了或者设成私有,还需要换 key 吗?

需要。仓库公开过,key 就可能已经被抓取、被 fork 或被缓存,删仓库只挡得住以后的人。先吊销换新,再处理仓库和 Git 历史。

前端代码混淆一下,能把 key 放在前端吗?

不能。混淆只会让人多花几分钟,浏览器发出的请求里 key 是可以直接看到的。正确做法是前端调你自己的后端,key 只留在服务端。

多久换一次 key 合适?

没有统一标准,常见做法是定期轮换,外包结项、成员离开、怀疑泄露时立即换。Anthropic 官方文档的建议是把 key 存进密钥管理工具、定期轮换、对怀疑泄露的 key 立即禁用或删除。分好 key 之后,换一把只是改一个环境变量。

找客服排错时可以把 key 发过去吗?

不要发完整 key。说明 key 的备注名或前缀、出错的时间和完整的报错信息,就足够定位问题;任何要你提供完整 key 的人都要提高警惕。

关于 cocodot

cocodot 是面向中国大陆开发者与出海团队的支付与 AI 接入服务:由持牌机构发行的美国卡段虚拟卡(用于在海外网站完成订阅与广告扣费),以及 OpenAI 兼容的 AI API 中转(在中国大陆直连调用 Claude、GPT、Gemini)。两者共用同一个钱包,支持支付宝 / 微信支付(人民币)、USDT / USDC 充值、以美元记账。卡费率:开卡 $9.9、充值到卡 3%、每张活跃卡每月 $1;消费:单笔 <$20 收 $0.60 结算费;发卡方按笔收费时另收相应费用。

服务范围、价格与能力边界 →
OpenAI 兼容 API · 人民币充值开通 API