很多人第一次听说 API Key,是在某个教程里看到「把你的 Key 填进去」这一句,然后就卡住了:这东西是账号密码吗?填到哪?发给别人会怎样?这篇不聊模型能力,只把 Key 这件事讲透——它是什么、能干什么、拿到之后放在哪、什么时候要换,让你读完能自己判断手上这把钥匙该怎么拿、怎么收。
很多人第一次听说 API Key,是在某个教程里看到「把你的 Key 填进去」这一句,然后就卡住了:这东西是账号密码吗?填到哪?发给别人会怎样?这篇不聊模型能力,只把 Key 这件事讲透——它是什么、能干什么、拿到之后放在哪、什么时候要换,让你读完能自己判断手上这把钥匙该怎么拿、怎么收。
先说清楚它的位置:Key 是平台发给程序用的一串凭证字符,不是给你登录网页的密码。你用它让脚本、客户端、自建小工具替你调用接口;每次调用算在谁的账号上、从谁的额度里扣,全靠这串字符来认人。所以它更像一张门禁卡,而不是身份证。
一句话:Key 是给程序用的身份凭证,不是给你登录的密码
理解 Key 最省事的办法,是把它和账号密码分开想。密码证明「登录的人是账号主人」,Key 证明「这次程序调用经过了账号主人的授权」。两者用途不同,泄露后的处理方式也不同:密码改了就行,Key 得去平台后台吊销再重发。
- Key 是一串由平台生成的字符,请求里带上它,服务器就知道这次调用算在谁头上,对应到账号和额度扣减;
- 它和你登录官网用的账号密码是两套东西,别混着填,也别互相替代;
- 所以 Key 一般只在代码、工具、客户端里用,正常不会出现在浏览器的登录框里;
- 一个账号可以生成多把 Key,方便按项目分开算账、单独吊销。
它能做什么、不能做什么
新手最容易高估 Key 的作用,以为拿到它就能解锁一切。实际上它只是一把调用凭证,权限和额度都挂在账号上,不挂在 Key 上。下面的表把常见的「能」和「不能」对着看,判断会更快。
| 场景 | Key 能做到吗 | 说明 |
|---|---|---|
| 让脚本调用模型接口 | 能 | 按你的账号额度计费,跟 Key 走调用记录 |
| 自动提额或开通新权限 | 不能 | 额度与权限由账号侧决定,Key 只是执行者 |
| 跨账号共享额度 | 不能 | 额度跟账号走,借 Key 不等于借额度给别人 |
| 给第三方工具临时用 | 能但不建议 | 对方每次调用都花你的额度,且你看不到即时提醒 |
把 Key 给第三方工具用,等于把账号的调用权借出去。对方用起来你这边只会看到用量上涨,不会有弹窗提醒,这是最容易被忽略的一点。想确认自己账号当前的实际用量和费用口径,到站内的价格与规格页面核对当时的数字,那里只讲费用规则,不对你的个人清单。
拿到之后放在哪:三种常见放法
拿到 Key 之后,真正的分水岭是「放在哪」。放错位置带来的风险,往往比 Key 本身能不能用更值得关心。下面按推荐程度从高到低排一个顺序,你按自己的场景对号入座。
- 写进环境变量最推荐的做法,代码运行时从环境里读取,Key 不落到源码里。具体配法见站内讲环境变量的那篇,配完可以用一行打印命令确认读到的值不是空的。
- 填进客户端配置界面适合不想碰代码的人。但要留意客户端把 Key 存在哪个文件里、会不会同步到云端,最好在官方说明里找到存储位置再决定。
- 硬编码在代码里只在本地临时试验时用。一旦提交到代码仓库就等于公开,事后必须去平台吊销重发,不要只做删掉这一步。
判断标准很简单:如果这把 Key 会离开你本机、或者会被别人看到,就优先走前面两种放法。反之,只是跑一次本地测试、跑完就删,硬编码也不是不能接受,但别忘了删干净。
什么时候该检查、该换一把新的
Key 不是发一次用一辈子。下面这几个时间点值得停下来想一下:换设备、把项目发给别人、有工具要求「粘贴你的 Key」。想清楚这把 Key 接下来会被谁看到、保存在哪,比事后补救省事得多。
- 按项目分 Key,出事时只吊销一把,不用把全部调用停掉;
- 怀疑泄露就先在平台侧吊销,再生成新的,两边操作顺序别反,反了会有一段空窗期;
- 把项目发给别人之前,先搜一遍代码和配置文件里有没有残留的 Key 字符串;
- 想知道账号下现在有哪些 Key、各自用量多少,登录平台后台看个人清单,站内的价格与规格页只对费用口径,不对你的清单。
| 触发信号 | 建议动作 | 不适用的情况 |
|---|---|---|
| Key 出现在聊天记录或截图里 | 尽快吊销重发 | 仅本地未外发的测试串可暂缓 |
| 工具要求粘贴 Key | 先确认对方是否长期保存 | 一次性本地脚本可评估风险后使用 |
| 多人共用同一把 Key | 按人拆成多把,便于追责 | 临时共用且用量极小可先观察 |
这套判断不适用于一种情况:你只是本地跑个演示、跑完就删、整套环境不出本机。这种情况下过度拆分 Key 反而增加管理成本,等真正接入线上或多人协作时再按上面的顺序做也不迟。
下一步想动手前先看一眼各家的费用口径和账号体系差异,免得拿了 Key 才发现计费方式和预期不一样。→常见问题
DeepSeek 的 API Key 和官网登录密码是同一个吗?
不是。密码用来登录网页、管理账号;Key 是给程序调用接口用的凭证。改了密码一般不影响已生成的 Key,但如果你怀疑账号被盗,两样都得处理:先改密码,再把所有旧 Key 吊销重发。
把 Key 发到群里或者贴进截图里,会有什么后果?
别人可以用它调用接口,费用记在你账号上,而且不会有通知。稳妥做法是立刻去平台吊销这一把,重新生成;如果只是发给同事协作,更该按项目拆 Key,而不是共用一把。
一把 Key 能不能同时给好几个工具用?
技术上可以,但不建议。多工具共用一个 Key,用量混在一起分不清是谁花的,某天某工具出问题你也没法只停它一个。按工具或项目各发一把,出问题吊销对应的那把就行。