算力猫
← 返回教程列表

排错与安全

Key 安全与最佳实践

Key 就是钱:怎么保管、怎么限权、泄露了怎么办。

约 6 分钟适合:所有拿到 Key 的用户

开始之前

  • 至少有一把 Key

步骤 1 · STEP 0x01

正确保管 Key

terminal
$ export API_KEY=<你的 Key>$ echo ".env" >> .gitignore
  • 放进环境变量或密码管理器,不要写进代码。
  • 不要提交到 git,尤其是公开仓库;.env 文件要加进 .gitignore。
  • 不要放进网页前端、手机 App 里的代码,任何人都能从里面读出来。
  • 不要发在聊天群、工单、截图里。
很多泄露来自「临时贴一下」:把配置贴到论坛求助时,先把 Key 换成占位符。

步骤 2 · STEP 0x02

一个用途一把 Key,并限权

API Key → 编辑
1

预算(USD)

设月度上限
2

模型白名单

只放这个用途需要的模型
3

IP 白名单

固定出口的服务器填 IP
4

过期日期

临时给别人的 Key 设到期日
5
保存
示意图,文字与实际页面一致,布局可能略有差别

这样即使某把 Key 泄露,损失也被限制在它自己的预算内,吊销时也不影响别的软件。

步骤 3 · STEP 0x03

打开提醒,定期检查

设置 → 邮件通知
1

余额不足提醒

开
2

Key 异常用量提醒

开
3

充值到账通知

开
4
保存
示意图,文字与实际页面一致,布局可能略有差别
  • 每周看一眼「用量」页,有没有你不认识的模型或时间段。
  • 在「API Key」页看「最近使用」,长期不用的 Key 直接吊销。
  • 定期修改登录密码;改密码后其他设备会被退出登录。

步骤 4 · STEP 0x04

怀疑泄露时按这个顺序做

API Key
1
吊销
2
创建 Key
示意图,文字与实际页面一致,布局可能略有差别
  • 1. 立刻吊销那把 Key。吊销后用它的请求会马上失败。
  • 2. 创建新 Key,更新到你的软件里。
  • 3. 到「用量」页查看泄露期间有没有陌生请求,有疑问的扣费提交工单(计费申诉,30 天内)。
  • 4. 找到泄露的来源(仓库、聊天记录、截图)并清理。
如果泄露的是账号密码,请立刻修改密码,并在工单里说明。

✓ 怎么确认成功了

  • 每把 Key 都有名字、预算和合适的限制;你知道泄露后第一步是吊销。

常见问题

分享页会泄露 Key 吗?

不会,分享页不含 Key,只含接入方式。Key 需要你另外发给对方。

可以几个人共用一把 Key 吗?

不建议。每人一把,谁出问题只吊销谁的,也便于看清谁用了多少。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。