创建 API Key
- 登录老张API控制台;
- 打开令牌管理;
- 按当前控制台要求选择名称、分组、额度或其他可用限制;
- 创建后立即复制并保存到安全位置;
- 使用最小请求验证端点、模型和计费分组。
推荐保存方式
环境变量
pip install openai):
echo、调试日志或异常信息输出密钥。
给令牌设置限制
创建或编辑令牌时,可以设置以下四项限制:- 授权额度是最该设置的一项:开着无限额度的令牌一旦泄露,损失上限就是全部余额。授权额度只是消耗上限,不会预先冻结余额;多个令牌共享同一个账户余额。
- IP 白名单要填服务器的公网出口 IP,可以填单个 IP 或 CIDR 网段,例如
203.0.113.0/24。家用宽带、办公网络的出口 IP 会变化,开启后 IP 一变调用就会全部失败,这类环境改用授权额度控制风险。 - 可用模型填写后,令牌调用其他模型会被拒绝。模型 ID 要与模型与价格总表完全一致;日常自用和探索测试一般不设置,以免每次换模型都要回来修改。
prod-image-service。出问题时可以只停用其中一个,不影响其他业务。不要在浏览器、移动端或公开客户端中嵌入服务器 API Key。
不要让密钥出现在这些地方
-
代码仓库:密钥提交进 Git 后,即使删除文件,仍留在提交历史里。把
.env加入.gitignore,提交前扫描一遍: - 文档、截图和日志:控制台截图、终端录屏和报错日志都可能带着完整密钥,示例里统一用占位符。公开仓库会被自动程序持续扫描,泄露的密钥可能很快被利用。
- AI 工具的对话:粘贴进 AI 编程工具的密钥通常会以明文留在本机会话记录和文件快照里。给 AI 工具单独建临时令牌,设小额度和较短的过期时间,用完即删,不要交出生产密钥。
轮换和撤销
出现以下情况时应立即轮换或撤销:- 密钥进入 Git、日志、截图、工单或公开消息;
- 发现来源不明的调用或余额变化;
- 员工、外包或系统权限发生变化;
- 依赖、服务器或部署凭证被入侵;
- 支持或安全团队要求采取措施。
- 创建新密钥并在受控环境验证;
- 更新服务端 Secret;
- 观察新密钥调用结果;
- 撤销旧密钥;
- 检查调用日志和受影响时间范围。
排查来源不明的调用
发现某个令牌有你不认识的调用时:1
先找这个密钥给过谁
复制该令牌的密钥,在聊天记录、代码仓库及提交历史、部署平台和 CI 的环境变量里全局搜索。多数“莫名调用”是某处遗留的旧配置仍在运行。
2
找不到就直接停用
在令牌管理停用该令牌。令牌相互独立,停用一个不影响账户下的其他令牌;确认需要后再新建一个替换。
3
用调用日志锁定来源
在调用日志按该令牌筛选,看调用的模型、时间段和来源 IP。重点关注你没用过的模型、非工作时间的调用和与业务量不符的请求数。
4
加固账户
修改账户密码,减少能登录控制台的人;员工只需要查询用量时,不必给控制台权限。