刚注册 OpenAI 账号,后台那一长串 sk- 开头的字符就是 API Key。很多人第一次见它,要么随手粘进聊天窗口、传到 GitHub,要么压根不知道它能干嘛。这篇不铺垫概念,直接说清它是什么、和登录密码有什么不同、怎么一步步建出来、平时放哪儿最稳,以及万一漏了先做什么。
刚注册完 OpenAI 账号,在后台点了一圈,会看到一串以 sk- 开头的长字符串,那就是 API Key。第一次见它的人通常干两件事:要么随手粘进聊天窗口问别人这是啥,要么直接传上代码托管平台。两种做法都可能让你后面花一笔说不清的钱。
下面按新手实际会走的顺序讲:它是什么、会用在哪些地方、怎么建、平时怎么放、怀疑漏了先干什么。只讲判断标准和动作,不给你背概念。
它到底是什么,和账号密码有什么不一样
API Key 是平台生成给你的一段凭证,程序拿它去调接口,用来表明「这次请求是哪个账号发的」。它不模拟人登录,也不走验证码那套,所以复制粘贴就能用,这也是它危险的地方。
- 登录密码
- 给人用的,进后台网页要输它
- API Key
- 给代码用的,脚本、插件、命令行工具读它
- 两者关系
- 互相替代不了,也不该放在同一个地方;改密码不会让已泄露的 Key 失效
- 数量
- 一个账号能建多把,按项目、按机器分开建,方便单独停用
- 显示次数
- 创建时完整显示一次,弹窗关掉后后台通常只剩前几位和后几位
- 它本身不带登录态,谁拿到谁就能以你的账号身份发请求。
- 一把 Key 被多台机器共用,出问题时你无法判断是哪台漏的,所以尽量一机一把。
- Key 通常可以设额度上限和过期时间,建的时候顺手设一下,比事后追账单省事。
- 后台看到的调用记录和花费,都是按 Key 维度能看出来的,这也是排查泄露的入口。
- 如果只是想在网页聊天框里问答,那不需要 API Key,那是另一套订阅制入口。
拿到 Key 之后,它会被用在哪几个地方
Key 的去处大致分三类:自己本机跑、交给第三方软件代跑、走非官方通道。三类的风险完全不同,别混着看。
| 使用场景 | Key 交给谁 | 要注意什么 |
|---|---|---|
| 本地脚本、命令行工具、编辑器插件 | 只在你自己的机器上 | 用环境变量读取,别写死在代码里 |
| 第三方客户端或平台 | 对方服务器 | 等于把调用权限借出去,先判断对方是否可信 |
| 中转站类通道 | 可能是对方自己的 Key,也可能要你填官方 Key | 这两件事风险差很多,先看清楚它要哪一种 |
| 网页对话产品 | 不涉及你的 API Key | 走的是订阅入口,和 API 是两套东西 |
判断标准很简单:凡是要你把官方 Key 填进别人页面的,先假设这把 Key 会离开你的控制。不适用的情况是,如果对方提供的是它自己签发的 Key,那你填的就不是官方凭证,出问题影响的是那个通道而不是你的账号。
建 Key 的标准动作,照着做一遍
- 先确认账号可用后台看一下付款方式和余额状态,没弄好的话,拿到 Key 也只会一直报额度类错误,白折腾。
- 给 Key 起个认得出的名字按项目或按机器命名,比如「笔记本脚本」「服务器定时任务」。别用 key1、key2,过两周你自己都不知道哪把该停。
- 当场复制并存好创建完成立刻粘进密码管理器或本地加密文件,别只留在浏览器标签和聊天记录里,关掉弹窗就看不全了。
- 顺手设额度上限同一页面把可花范围先框住,设一个你能接受的数,别等账单出来才反应。
- 记一笔用途在密码管理器里写清这把 Key 给谁用、什么时候建的,将来要停用时能对上号。
官方后台的具体入口位置和额度设置项,各家改动比较勤,去 /tools 里的相关工具页面对一下当前界面更稳。想把这类配置动作做成清单的,也可以先看一眼 /guides 里的入门类文章。
日常保管:哪些动作一律不要做
- 不要把 Key 写进代码文件再提交到代码托管平台。这是最常见的泄露途径,而且提交记录里删掉也没用,历史还在。
- 不要在截图、录屏、群聊、工单里贴完整 Key。需要别人帮你排查时,先临时建一把用完就删的。
- 本地尽量用环境变量或系统密钥库读取,让 Key 不落在明文文本里,也不进代码目录。
- 不同项目用不同的 Key,一旦怀疑某把泄露,只停那一把,不用把整套配置推翻重来。
- 不要把 Key 存在共享文档、共享网盘和团队聊天工具里,那等于把通行证挂在公共走廊。
# 本地临时设置,只对当前终端会话生效;不要把真 Key 写进脚本文件导出 OPENAI_API_KEY="你的Key";# 运行前先看一眼是否已经被设置echo $OPENAI_API_KEY哪些情况下上面的做法不适用?如果你是在多人共用的服务器上跑任务,环境变量也可能被同机器上其他人读到,这时候应该用系统密钥管理服务或单独的运行账号,而不是简单 export。
怀疑泄露了,按这个顺序处理
顺序很重要,先做能立刻止损的那一步,再去找原因。很多人第一反应是改登录密码,但改密码不会让已经流出去的 Key 失效。
- 删掉可疑的那把 Key去后台直接删,别只想着改。Key 是独立凭证,删除才是真正的断点。删完立刻确认它已经不在列表里。
- 翻用量和调用记录看有没有不是你发起的调用、有没有对不上的花费。数字到 /price-watch 这类站内页面核对当时的行情,别凭印象。具体花了多少以后台记录为准。
- 查泄漏源头是代码仓库、共享文档,还是某台机器被人看过。源头不清掉,换一百把 Key 也是重复一遍。
- 按项目重建重新建新 Key,额度上限重新设一遍,用途重新记一笔。只重建受影响的那几把,不用全部推倒。
- 评估是否升级为账号安全问题如果同时出现异常登录、付款方式被改这类迹象,那就不是单把 Key 的事,按账号安全流程一起处理。
想对一下别人踩过哪些坑、哪些第三方通道要更小心,可以到 /sites 翻一翻当前收录的通道说明,判断标准比结论更有用。
下一步把 Key 的用途、额度、存放位置过一遍,比记住定义有用得多;站内收录的通道说明和检测工具可以帮你判断哪些地方不该填官方 Key。→常见问题
API Key 能给别人用吗?
建议不要直接给。别人拿到就等于拿到你的额度和账单控制权,而且你无法判断他会拿去调什么。协作场景下更稳的做法是让对方用自己的账号,或者由你在中转或自建服务这层做权限隔离,只开放特定模型和固定额度。
为什么我的 Key 明明是对的,调用还是失败?
Key 正确但失败,多半不是 Key 本身的问题,可能是额度不足、账号未完成验证、模型没有权限,或者请求发到了错误的接口地址。先按报错里那串英文代码去查含义,再逐项排除,比反复重建成新 Key 有效得多。
Key 会过期吗?需要定期更换吗?
通常不会自动过期,除非你主动删除或被平台判定风险而失效。换不换取决于使用场景:个人本地自用、没外泄过可以长期不换;有共享、上传仓库、多人协作的情况,建议按固定周期轮换一次,把旧的直接删掉。