深度求索(DeepSeek),成立于2023年,专注于研究世界领先的通用人工智能底层模型与技术,挑战人工智能前沿性难题。基于自研训练框架、自建智算集群和万卡算力等资源,深度求索团队仅用半年时间便已发布并开源多个百亿级参数大模型,如DeepSeek-LLM通用大语言模型、DeepSeek-Coder代码大模型,并在2024年1月率先开源国内首个MoE大模型(DeepSeek-MoE),各大模型在公开评测榜单及真实样本外的泛化效果均有超越同级别模型的出色表现。和 DeepSeek AI 对话,轻松接入 API。
官网:https://www.deepseek.com/
开放平台:https://platform.deepseek.com/
我们申请api key需要在开放平台申请。
一、引言
很多新手做代码开发、数学推理、本地知识库 RAG 时会选择 DeepSeek 大模型,但绝大多数人卡在实名认证、找不到密钥入口、调用代码报错、不清楚兼容 OpenAI 接口规则。官方文档偏向开发者专业说明,新手很容易踩额度、鉴权、模型名称相关的坑。本文全程大白话实操讲解,手把手教大家完成 DeepSeek 账号实名、API Key 创建、本地代码测试,把高频踩坑点一次性讲清,拿到密钥就能直接运行。
二、DeepSeek API 前置须知
- 账号 & 实名硬性规则
仅手机号 / 邮箱注册账号无法创建 API Key,必须完成个人实名认证才能解锁密钥管理功能;

个人开发者:身份证正反面 + 人脸核验,审核一般几分钟到 1 个工作日; 企业开发者:上传营业执照、法人信息,适合商用线上项目。 未实名账号仅能网页端对话,完全无法使用任何 API 接口。
- 免费额度说明
新用户实名审核通过后自动发放一次性免费 Token 额度,有效期 30 天;
免费额度消耗完毕后,需要账户充值余额才能继续调用,按 Token 按量计费;
无永久免费轻量化模型,所有模型统一消耗账户额度。
- 主流模型极简选型(新手避免调用报错)
deepseek-chat:通用对话模型,文案、问答、日常工具首选;deepseek-reasoner:深度推理模型,数学计算、逻辑解题、复杂代码调试专用;deepseek-v4-flash:轻量高速版,低成本批量生成文本,性价比最高。
- 核心特色 & 适用人群 API 完全兼容 OpenAI 调用格式,现有 OpenAI 项目只需要修改 base_url 即可无缝切换; 适合程序员写代码、本地 RAG 知识库、数学科研、自动化脚本开发; 新手门槛:无需域名备案、服务器资质,本地 Python 环境即可调用。
【这里放一张 DeepSeek 控制台账户额度、模型列表页面截图】
三、DeepSeek API Key 获取完整步骤(现有登录账号截图演示,无需注销重注册)
1. 登录 DeepSeek 官方开放平台控制台
讲解:浏览器打开 platform.deepseek.com,支持手机号验证码、邮箱登录,右上角切换简体中文;登录后直接进入开发者后台主页。
【这里放一张 DeepSeek 登录页面截图,标注登录入口、语言切换按钮】
2. 完成实名认证(前置强制步骤)
讲解:点击右上角头像,下拉进入「账户设置」,找到实名认证入口,按提示上传身份证并完成人脸核验;状态显示「已通过」,才会解锁左侧 API Keys 菜单栏。 【这里放一张账户设置实名状态页面截图,红框标注实名通道】
3. 左侧菜单栏进入 API Keys 密钥管理页面
讲解:实名认证通过后,侧边导航栏会出现「API Keys」选项,点击进入全部密钥管理列表,可查看历史创建的密钥用量、状态。
【这里放一张控制台左侧导航栏截图,圈出 API Keys 菜单】
4. 创建全新 API Key 并命名
讲解:页面点击「创建新的 API Key」,自定义填写密钥名称(本地测试、代码项目、RAG 工具方便区分),确认提交生成密钥。

5. 立刻复制保存密钥(重中之重)
讲解:密钥以sk-开头,创建弹窗仅展示完整字符串一次,关闭页面、刷新页面后永久无法查看;密钥丢失只能删除旧密钥重新生成。

四、新手必踩坑汇总
坑 1:【实名强制限制】只注册账号不实名,左侧不会出现 API Keys 菜单,完全无法生成密钥,和智谱无实名可用 Key 完全区分开。
坑 2:【兼容接口配置坑】复制 OpenAI 项目代码调用时,忘记填写
base_url="https://api.deepseek.com",直接报接口 404 访问失败。坑 3:【额度欠费报错】免费额度到期 / 账户无余额,调用直接返回鉴权失败,新手误以为是密钥失效。
坑 4:【模型名称写错】填错
deepseek-reasoner、deepseek-chat模型 ID,返回模型不存在报错,区分推理与通用对话模型使用场景。坑 5:【密钥安全隐患】不要明文写在开源代码、Github、公开博客,密钥泄露会消耗账户余额;闲置密钥及时后台删除。
坑 6:【多密钥管理坑】多个项目共用一个密钥,无法区分各工具 Token 消耗,建议每个项目单独新建独立密钥。
五、极简调用测试代码
方式 1:推荐方案(复用 OpenAI SDK,无需额外安装专用包)
# 先安装依赖:pip install openai
from openai import OpenAI
# 替换为你保存的DeepSeek API Key
client = OpenAI(
api_key="sk-你的DeepSeek密钥",
base_url="https://api.deepseek.com" # 核心配置,必须填写
)
# 通用对话测试
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role":"system","content":"简洁回答问题"},
{"role":"user","content":"DeepSeek API和智谱GLM调用有什么区别?"}
]
)
print(response.choices[0].message.content)
方式 2:原生 requests 请求(不安装第三方 SDK)
import requests
api_key = "sk-你的DeepSeek密钥"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type":"application/json"
}
data = {
"model":"deepseek-v4-flash",
"messages":[{"role":"user","content":"写一段简单Python测试脚本"}]
}
res = requests.post("https://api.deepseek.com/v1/chat/completions", headers=headers, json=data)
print(res.json()["choices"][0]["message"]["content"])
六、日常使用建议 & 密钥安全规范
用量监控:控制台「用量账单」实时查看每个 API Key 的 Token 消耗,区分不同项目调用数据;
余额预警:充值页面设置余额提醒,余额不足自动短信通知,避免调用中断;
密钥隔离规范:本地测试、线上项目分开创建两套密钥,线上密钥绝不用于本地调试;
环境变量存储:正式项目将密钥存入系统环境变量或.env 文件,禁止硬编码写死在源码;
推理模型场景:数学、复杂算法问题选用
deepseek-reasoner,普通文案使用 chat/flash 降低成本。