deepseek api key是什么意思怎么获取

入门与上手

讲清 DeepSeek API Key 到底是什么、长什么样、去哪申请,以及拿到之后怎么把它放对位置、跑通第一次调用。

很多人第一次接触 DeepSeek,是在网页版聊得挺顺,想接到自己的脚本或工具里时卡住了:后台找不到入口、复制出来的东西不知道往哪填、填完又怀疑是不是填错了。这篇按「它是什么 → 去哪拿 → 怎么放 → 怎么验」的顺序走一遍,不给具体数字和版本,数字类的东西一律让你回站内对应页面核对当时的实际情况。

很多人第一次接触 DeepSeek,是在网页版聊得挺顺,想接到自己的脚本或工具里时卡住了:后台找不到入口、复制出来的东西不知道往哪填、填完又怀疑是不是填错了。这篇按「它是什么 → 去哪拿 → 怎么放 → 怎么验」的顺序走一遍,数字类的东西一律让你回站内对应页面核对当时的实际情况。

先说清一件事:本篇讲的是「拿到一把能用的钥匙并让它开第一扇门」,不涉及价格比较、也不做选型推荐。你只要跟着走完,能跑通一次最小调用,剩下的优化可以后面慢慢来。

API Key 到底是把什么东西

一句话定义:它是一串代表「你或你这个项目」身份的凭据,服务端靠它认出请求来自谁、该记到哪个账上。它不是账号密码,也不等同于你登录网页版的登录态——登录态管的是「你是不是这个人」,API Key 管的是「这次请求算谁的」。

API Key
长期有效的调用凭据,可手动创建、可手动吊销,发给服务端用来识别请求归属
access_token
偏临时会话性质,通常有过期时间,多用于用户授权场景
app_token
偏应用维度,代表某个已注册的应用而不是某个人

为什么不能直接写死在代码里、更不能截图发群里:任何人拿到这串东西,都能以你的名义发出请求、消耗你的额度。把它当银行卡号和密码一起保管,是最省心的思路。相关词条的准确定义,可以到 /ai-dict 里对照。

去哪拿、拿之前要准备什么

  1. 第一步:确认账号状态能正常登录官方开放平台,验证环节该过的都过了。登录都进不去的账号,创建按钮点不动是正常的,先解决账号问题。
  2. 第二步:找对地方官方开放平台和各家中转站是两个不同的地方,入口和凭据互不通用。你要用的是哪一个,得先想清楚,别在一处建了 Key 拿去另一个地方填。
  3. 第三步:新建并当场保存在密钥管理那一页新建一条,创建完成后立刻复制走。多数平台只在创建那一刻完整显示一次,关掉页面就只剩打码状态了。
  4. 第四步:记名字和用途顺手给它起个能看懂的名字,比如「测试用」「某个小工具用」,将来要停用只停这一条,不影响别的项目。

建议一开始就按用途分开建 Key,而不是所有项目共用一把。共用的坏处很明显:某个项目要下线或者凭据疑似外泄时,你不敢停,一停全挂;分开建就没有这个纠结。

关于这个平台的模型清单和计费口径,别拿第三方文章里的截图当准,那些图很容易过期。直接到 /official-api/providers/deepseek 看当时的实际情况。

拿到之后放哪:三个位置和一个坑

放置位置适合场景要注意什么
环境变量本地开发、服务器部署,最推荐不要写进代码,也不要提交到仓库
本地配置文件临时试验、个人小工具必须写进 .gitignore,提交前扫一眼
平台密钥管理页留个名目和用途只记名称,别把值明文贴进笔记软件

环境变量是首选,理由很朴素:代码可以开源、可以发给同事看,而凭据留在你自己的机器上。具体怎么设、Windows 和 macOS 分别怎么写,站内 env-var-api-key-setup 讲得比较细,照着做就行。

  • 写进 .gitignore 之后再提交,提交前用 git status 确认没有把它带上
  • 贴进聊天工具、截图、录屏前,先确认屏幕上没有完整明文
  • 换电脑或换协作者时,第一件事是吊销旧 Key,再建新的
  • 怀疑外泄了不要犹豫,直接删掉重建,比追查是谁拿走的更快
  • 不要把 Key 和账号密码放在同一个笔记里,一处泄露就全丢

一个高频的坑:Key 和接口地址(Base URL)是两样东西,填错位置会直接报认证失败。接口地址相关的字段怎么读、命名习惯是什么,可以对照 /ai-dict/category/basics 里的基础词条。更完整的安全保管清单,站内 api-key-storage-safety 有专门一篇。

跑通第一次调用:按这个顺序排错

不要一上来就把 Key 塞进正式项目里跑。先做最小验证:只发一句最短的测试请求,看能不能拿到返回。跑通之后再往项目里搬,这样出问题时你能确定是凭据问题还是代码问题。

报错表现先怀疑什么下一步动作
认证失败、无权限Key 本身错、前后有空格换行、填到了错误的字段重新复制一次,别手打,检查首尾有没有多余字符
找不到接口、404接口地址写错,或路径拼接多了斜杠对照官方文档里的地址逐字符核对
被限流、频繁失败请求频率过高,或额度用尽降速重试,并去后台看账户状态

报错文本的逐条解读,站内 api-errors 有汇总,遇到不认识的错误码先去那里翻。别一看到报错就换 Key,很多情况下换十把也没用——问题不在凭据上。

  1. 量一个延迟基线在同一台机器上连测几次,记下自己这边的正常水平。以后感觉变慢了,才有参照物可以对比,站内 /tools/speed-test 可以直接用。
  2. 小流量试跑跑通之后先小流量跑一阵,确认返回内容和账目能对得上,再考虑加并发和批量。
  3. 盯一眼用量前几次调用后回后台看看用量记录有没有正常累加,没累加说明可能根本没打到正确的地方。
下一步跑通第一次调用之后,很多人会开始纠结价格和响应速度的取舍。这类数字变化快,去 /price-watch 看当时的实际记录,比翻旧文章靠谱。

常见问题

DeepSeek 的 API Key 和网页版账号是同一个东西吗?

不是。网页版登录用的是账号体系,API Key 是给程序调接口用的凭据,两者在后台通常是分开管理的。有网页版账号不代表自动就有 Key,反过来吊销 Key 也不影响你继续用网页版。具体入口和开放范围以官方开放平台的当前说明为准。

Key 创建时没复制下来,还能再看到吗?

多数平台出于安全考虑只在创建那一刻完整显示一次,之后列表里只留名称和前缀。看不到完整值时,最省事的做法是直接新建一条、把旧的停用,而不是到处翻记录或者去猜。已经流出去的那条记得及时吊销。

填进代码里能用,是不是就可以直接上线了?

能用只是第一步。上线前至少确认三件事:Key 是从环境变量读的而不是硬编码、这个 Key 的额度或权限有上限、有地方能看到它的调用量。三条里缺哪条都建议先补上,再对外放流量。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。