申请 deepseek 模型的 api key

很多人卡在不是不会写代码，而是注册完找不到 Key 在哪、实名过不了、复制出来的密钥一调就 401。这篇按顺序走一遍：从进官网注册、完成必要验证、在控制台建 Key，到把它塞进环境变量跑通第一个请求，并给出失败时的排查顺序。

很多人卡住的地方不是不会写代码，而是注册完绕了半天找不到 Key 在哪、实名那关卡住、好不容易复制出来的密钥一调就 401。这篇就按真实顺序走一遍：进官网注册、完成必要验证、在控制台建 Key，再到把它塞进环境变量跑通第一个请求。每一步都告诉你做完之后怎么验证，别等报错了才回头猜。

提醒一句：不同平台的控制台长得不一样，DeepSeek 官方和各家聚合平台的入口、认证方式、计费口径都有差别。下面讲的是通用动作和判断标准，具体按钮位置和当时的额度数字，以你登录的那个控制台为准。

动手前先确认三件事

注册本身不难，难的是注册完发现走错了路。动手前花两分钟把下面三点确认掉，后面能少很多返工。尤其是「用途」这一条，很多人只是本地跑个脚本，却按线上服务的标准去纠结额度和并发，纯属自己给自己加戏。

官方直连 Key

在模型方自己的开放平台注册，计费、限流、模型版本都以它为准。

中转站/聚合 Key

在第三方平台注册，一个 Key 可能对应多家模型，入口和计费口径不同。

实名或开发者认证

部分平台强制要求，过不了这步后面全白搭，先确认自己材料齐不齐。

用途

本地脚本试跑和接进线上服务，对额度、并发、稳定性的要求完全不是一回事。

• 先确认你要的是官方直连 Key 还是中转站 Key，两条路的注册入口和计费方式不一样；
• 确认手上账号能完成实名或手机号验证，材料不齐就先别往下走；
• 想清楚用途：本地试跑可以宽松点，要接线上服务就得提前看并发和额度限制；
• 准备好一个干净的存放位置，密码管理器或加密文件都行，别打算随手存聊天记录。

注册账号与完成验证

注册这一步最常见的坑是验证码收不到。收不到别急着换平台，按下面顺序排查多半能解决。注册完先别冲去建 Key，把账号安全项补齐，这是给自己留后路——Key 一旦泄露，有绑定信息你还能及时处理。

1. 用常用邮箱或手机号注册优先选你平时收信正常的邮箱。验证码收不到时，依次换邮箱域名、检查垃圾箱和拦截规则、换个浏览器或无痕窗口重试。
2. 完成实名或开发者认证按平台提示提交。信息填错会被打回，重新提交通常还要再等一轮，所以提交前把姓名、证件号、手机号核对一遍，别手快。
3. 补齐账号安全项登录后先把绑定手机、二次验证这类开关打开，再动手建 Key。这一步花不了几分钟，但 Key 出问题时它是你唯一的追回入口。
4. 确认账号状态正常在控制台首页看一眼账号是否已激活、有没有待处理的认证提醒，别带着「认证中」的状态去建 Key。

在控制台创建并保存 Key

这节是整个流程里最容易埋雷的地方。Key 的命名、保存方式、以及创建那一刻的额度状态，都会影响你后面调试顺不顺。下面这张对照表把几个容易忽略的点列出来，照着核对一遍。

• Key 名字起得能认出来，比如按项目或环境区分，别一堆叫「默认密钥」；
• 复制后立刻存进密码管理器或本地加密文件，不要落在聊天记录、截图、粘贴板历史里；
• 顺手确认默认模型和可用额度，额度吃紧时调用会失败，但不一定给你明确提示；
• 建完先别关页面，把 Key 前缀记一下，方便后面在列表里对上号。

把 Key 接进代码：最小可跑示例

第一次调用别写业务逻辑，先跑通一个最简请求。下面给个 OpenAI 兼容思路的示意，具体接口地址和模型名以官方文档为准，DeepSeek 提供 OpenAI 兼容格式，多数 OpenAI SDK 通常只需改 base_url 和 key 两处。

export DEEPSEEK_API_KEY=你的密钥；# 本地放 .env 并加进 .gitignore；# 服务器上用平台的环境变量配置，别硬编码进代码

1. 用环境变量而不是硬编码本地写 .env 文件并加进 .gitignore，服务器上用平台的环境变量面板配置。验证方法：把代码里的密钥字符串全删掉，程序仍能跑通就对了。
2. 第一次只发最简请求只发一句测试消息，确认能正常返回内容。这一步只验证连通性，不要顺手改业务逻辑。
3. 确认 base_url 和模型名对照官方文档核对接口地址和模型标识，写错了通常表现为 404 或提示模型不存在。
4. 跑通后再往业务里搬把验证过的最小配置整体复制过去，不要一次改太多变量，否则出问题很难定位是哪处改坏的。

常见的几类报错与排查顺序

报错别乱猜，按身份类、额度与限流类、网络与超时类的顺序过一遍，能覆盖大多数情况。先排除最简单的可能，再怀疑复杂的。

• 先看错误码，别一上来就怀疑大模型本身出问题；
• 身份类问题优先重新复制一遍 Key，排除空格和换行；
• 额度问题去控制台看当时的数字，不要凭记忆判断；
• 超时先换网络环境复现，能稳定复现再看代理和客户端配置。