DeepSeek 是由杭州深度求索人工智能基础技术研究有限公司开发的开源大语言模型系列,核心定位是“国产、开源、强推理、低成本”。它解决的关键问题是:此前强推理能力集中在闭源模型(如 OpenAI o1)手中,API 价格高、数据须出境、无法私有化;而 DeepSeek 以 MIT 协议开源模型权重,可商用、可私有化部署,同时 API 定价约为同类闭源模型的 1/10 量级。截至 2025 年 5 月,开源生态包含 DeepSeek-V3(671B MoE 通用模型)、DeepSeek-R1(深度推理模型)及其 1.5B-70B 蒸馏版本,其中 R1 在 AIME 2024 数学竞赛上达到 79.8% 准确率,与 OpenAI o1 持平。 本文从安装配置、API 调用、核心能力、生产部署与选型对比五个方面给出完整上手路径。无论你是想最快速度接入 API 做应用,还是计划私有化部署满足合规要求,都能在本文找到可直接操作的步骤。
掌握 DeepSeek 意味着同时拥有开源推理模型、私有化部署路径与远低于闭源模型的 API 成本,是 AI 从业者低门槛进入深度推理生产实践的优选工具。
目录
速览卡是工具类内容的固定首屏模块:30 秒判断「这工具是什么、能不能商用、适不适合我」。
为什么需要 DeepSeek:开源推理模型的成本与自主权
2024 年之前的局面是:强推理能力集中在闭源模型(OpenAI o1 系列),API 价格高、数据须出境、无法私有化;开源模型虽有多种选择,但推理能力与闭源差距明显,在数学、代码等任务上难以达到生产标准。对国内团队而言,还叠加了合规与供应链风险。
DeepSeek 以两个关键动作打破这一局面:一是 2024 年 12 月发布 V3,以约 557 万美元训练成本(2.788M H800 GPU 小时)达到接近 GPT-4o 的通用能力;二是 2025 年 1 月发布 R1,首次将 o1 级别的链式推理开源,并公开了强化学习训练方法。MIT 协议授权商用与二次分发,API 定价显著低于同类闭源模型。
与 Qwen 的全尺寸覆盖、GLM 的企业服务整合相比,DeepSeek 的气质是“以算法效率最大化单点性能”:用 MoE 稀疏激活(每次推理只激活部分参数)与 MLA 注意力(压缩 KV 缓存)把推理成本压到最低,用 R1 验证纯强化学习路线。这意味着它在成本敏感和高难度推理场景有独特优势。
安装与环境配置:3 步就绪
步骤一:注册并创建 API Key。 访问 platform.deepseek.com,注册账号后完成实名认证,在「API Keys」页面创建密钥(sk- 开头)。充值少量余额即可调用,新账号通常有赠送额度,以官网活动为准。
步骤二:安装 OpenAI SDK。 DeepSeek API 与 OpenAI 接口格式完全兼容,直接安装 openai 包,只需替换 base_url 即可。
步骤三:配置密钥并验证。 将密钥写入环境变量,用下方案例发起首个对话请求。
验证标准:正常返回中文文本即配置成功。注意 deepseek-chat 映射 V 系列、deepseek-reasoner 映射 R 系列,两者都会随官方升级自动指向最新版本。
pip install openaiexport DEEPSEEK_API_KEY="sk-你的密钥"
import osfrom openai import OpenAI client = OpenAI( api_key=os.environ["DEEPSEEK_API_KEY"], base_url="https://api.deepseek.com") resp = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "用一句话介绍 MoE 架构"}], max_tokens=200)print(resp.choices[0].message.content)
快速上手:5 分钟跑通第一个示例
核心思路是先用对话模型完成日常任务,再用推理模型处理高难度题目,对比两者差异。输入同一道数学题,观察 reasoner 会先输出思考过程再给结论,而 chat 直接回答。
1. 在 platform.deepseek.com 创建 API Key,充值约 10 元即可完成全部测试。
2. 将密钥写入环境变量 DEEPSEEK_API_KEY。
3. 用上方 Python 脚本分别请求 deepseek-chat 与 deepseek-reasoner,输入问题“9.11 与 9.8 哪个大”。
4. 观察输出:deepseek-reasoner 会先返回 reasoning_content 字段(思考过程),再返回最终答案。
5. 进阶操作:将请求参数改为 stream=True 可逐字流式返回,适合接入聊天类 UI。
核心能力详解:4 大支柱
支柱一:开源深度推理(DeepSeek-R1)。 R1 通过大规模强化学习让模型在给出答案前生成 Chain-of-Thought(思维链,模型逐步推理的中间过程),在 AIME 2024 数学竞赛上达到 79.8% pass@1,与 OpenAI o1 持平;Codeforces 竞赛评级 2029,超过 96.3% 人类参赛者。官方同时开源了基于 Qwen/Llama 蒸馏的 1.5B-70B 小模型,可在消费级显卡运行。注意:思维链 token 会被计费。
支柱二:MoE 混合专家架构(DeepSeek-V3)。 MoE(Mixture of Experts,混合专家)将模型拆分为多个“专家”子网络,每次只激活其中一部分。V3 总参数 671B,但每次推理仅激活 37B,大幅降低算力开销。配合 MLA(Multi-head Latent Attention,多头潜在注意力)压缩 KV 缓存,使 API 能以低价提供 128K 长上下文服务。这是 DeepSeek 成本优势的架构基础。
支柱三:超长上下文与工具调用。 V3 与 R1 均支持 128K 上下文,可处理整本书或长代码文件;支持 JSON Output(按指定 JSON 格式输出)与 Function Calling(函数调用,模型按约定输出结构化参数供程序执行)。注意:R1 的 Function Calling 仅支持中文与英文输入,具体语言兼容性以官方文档为准。
支柱四:开放权重与低成本 API。 模型权重以 MIT 协议开源,可在 Hugging Face 下载;蒸馏版可在单张 24GB 显卡上运行。API 定价(截至 2025 年 5 月):deepseek-chat 输入 2 元/M token、输出 8 元/M token;deepseek-reasoner 输入 4 元/M、输出 16 元/M,约为同类闭源模型价格的 1/10 量级,实际价格以官网实时为准。
生产部署与监控:从上线到运维
部署方式一:官方 API(推荐起步)。 零运维,分钟级接入。在开放平台配置用量告警与单日消费上限,防止异常调用。API 按量计费、无需预付费,但需关注平台并发限制。此方式适合快速验证业务、中小流量起步。
部署方式二:私有化部署。 用 vLLM 或 SGLang 加载 DeepSeek-V3/R1 的 671B 权重,按 FP8 量化估算需约 8 × H100 80GB 的多卡集群;消费级显卡无法运行全量模型,只能运行蒸馏版(如 R1-Distill-Qwen-7B 单张 24GB 显卡可跑)。部署时使用 vLLM 的 OpenAI 兼容 server 模式,客户端只需改 base_url 即可无缝迁移。
可观测性: 官方 API 侧在平台面板查看 token 消耗、请求量与费用明细;私有化部署侧接入 Prometheus 监控 GPU 利用率与 Token 吞吐,Grafana 做可视化。生产环境建议补充:输入输出内容过滤、PII 脱敏(在调用前对个人信息做脱敏处理)、多 Key 轮询与失败重试。
<p class="para-label">避坑清单:</p>
<ul class="dash-list"><li>思维链计费陷阱:deepseek-reasoner 的思考过程按 token 计费且不可关闭,长思维链会使单次成本显著高于 deepseek-chat,成本敏感场景先用 chat 试跑;</li><li>长输出静默截断:max_tokens 默认值为 4K,长文生成不报错但内容被截断,务必按任务需要显式调大该参数;</li><li>蒸馏版 ≠ 原版:R1-Distill 系列基于 Qwen/Llama 的小模型,推理能力接近但不等同于 671B 原版 R1,复杂长链推理场景谨慎使用。</li></ul>
| 维度 | DeepSeek | Qwen(通义千问) | GLM(智谱) | GPT-4o / o1 |
|---|---|---|---|---|
| 定位 | 开源推理黑马,成本效率优先 | 开源全尺寸覆盖,商业与开源并重 | 国产商用全栈,企业服务完善 | 闭源行业标杆,能力最全面 |
| 编排范式 | OpenAI 兼容 API + 开源权重 | OpenAI 兼容 API + 开源权重 | OpenAI 兼容 API + 部分开源权重 | 闭源 API,无权重开放 |
| 类型约束 | 对话(V3)+ 推理(R1)双线 | 对话为主,多模态能力强 | 对话为主,企业级深度服务 | o 系列专注推理,生态最成熟 |
| 学习曲线 | 低(API 与 OpenAI 一致) | 低 | 低 | 低 |
| 生态集成 | Hugging Face、vLLM、OpenAI SDK | 阿里云百炼、ModelScope 国内生态强 | 智谱开放平台、私有化方案完善 | 全球工具链与第三方集成最全 |
| 生产部署 | API 便宜,全量私有化门槛高 | API 与私有化选择多,尺寸齐全 | 企业级服务与合规方案成熟 | 仅云端,无私有化选项 |
| License | MIT(权重开源) | Apache 2.0(Qwen2.5) | 部分开源(如 GLM-4-9B) | 闭源 |
| 适合谁 | 成本敏感、需私有化、高难度推理 | 国内云生态、需多尺寸多模态 | 企业客户、需合规定制服务 | 追求极致效果、预算充足 |
选型建议:预算充足且不涉及数据出境,直接选 GPT 系列;需要国内合规与私有化,在 DeepSeek 与 Qwen 之间按“推理强度 vs 生态广度”取舍——高难度数学/代码任务选 DeepSeek,需要多模态与国内云深度集成选 Qwen;企业定制化服务要求高的选 GLM。
版本迭代
DeepSeek 的演进主线是“成本—能力双重突破”:V2 用 MoE + MLA 把推理成本打下来,V3 在低成本下追平主流闭源模型,R1 把深度推理能力开源并公开训练方法,随后通过小版本升级持续强化代码与推理能力。(截至训练数据,可能已有更新版本)
| 版本 | 时间 | 变化 | 提升 |
|---|---|---|---|
| DeepSeek-V2 | 2024-05 | 引入 MoE 与 MLA 注意力 | 推理成本约为同规模 Dense 模型的 1/3 |
| DeepSeek-V2.5 | 2024-09 | 通用能力增强、对齐优化 | 写作、指令跟随等任务明显提升 |
| DeepSeek-V3 | 2024-12 | 671B MoE 架构,训练成本约 557 万美元 | 多项基准接近 GPT-4o,开源后全球下载量激增 |
| DeepSeek-R1 | 2025-01 | 首个开源深度推理模型,强化学习训练 | AIME 2024 达 79.8%,接近 o1 水平 |
| DeepSeek-V3-0324 | 2025-03 | 代码与前端能力增强 | 编程能力提升,部分场景接近 Claude Sonnet |
| DeepSeek-R1-0528 | 2025-05 | 推理强化与稳定性改进 | 推理任务表现进一步提升,API 同步更新 |
| 基准 | DeepSeek-V3 | DeepSeek-R1 | |
|---|---|---|---|
| MMLU(通用知识) | 88.5 | 90.8 | R1 在通用知识上也有小幅提升 |
| AIME 2024(数学竞赛)pass@1 | 39.2 | 79.8 | R1 推理能力显著领先,接近 o1 |
| MATH-500(数学题集)pass@1 | 90.2 | 97.3 | 数学是 R 系列核心优势领域 |
| GPQA Diamond(研究生级科学问答) | 59.1 | 71.5 | 反映专业领域推理深度 |
V 系列负责通用对话与成本效率,R 系列负责高难度推理,两条产品线定位清晰。选型上不必追逐每个小版本,而是按任务类型选择系列——API 的 deepseek-chat / deepseek-reasoner 会自动跟踪系列最新版,业务侧无需频繁改代码。
AI 应用场景
高难度推理任务(数学、代码竞赛)
阶段:推理模型选型 / 模型效果调优
解决的问题:通用对话模型在数学证明、编程竞赛题上准确率不足;闭源推理模型 API 昂贵且数据须出境。DeepSeek-R1 提供开源推理模型,API 价格约为 o1 的 1/25,思维链可逐步自校验,在 AIME 2024 上达 79.8% 准确率。
具体案例:某 AI 编程教育平台接入 deepseek-reasoner 做解题步骤生成与代码纠错;R1 在 Codeforces 竞赛评级 2029(超过 96.3% 人类参赛者),单题解答成本从同类闭源的 0.1 元级降至 0.01 元级。
企业级低成本对话与 RAG 问答
阶段:RAG 管道构建 / 对话系统开发
解决的问题:企业客服与知识库场景对话量大、成本敏感。DeepSeek-V3 中文能力强、128K 上下文可容纳长协议文本,配合 Function Calling 可结构化抽取信息,API 成本约为 GPT-4o 的 1/10。
具体案例:某企业内部文档问答系统接入 deepseek-chat,配合向量检索构建 RAG 管道;按输出 500 token/次估算,单次回答成本从 GPT-4o 的约 0.035 元降至 0.004 元,月均调用 10 万次节省约 3000 元。
私有化部署与数据合规场景
阶段:模型服务化 / 合规部署
解决的问题:金融、政务等场景要求数据不出域,闭源 API 无法满足。DeepSeek 开源权重 + MIT 协议可本地部署;全量 671B 需多卡集群,蒸馏版 7B/32B 可在单卡或小规模集群运行。
具体案例:某金融机构内网部署 R1-Distill-Qwen-32B(FP16 约需 64GB 显存,单张 A100 80GB 可运行),在保证数据不出域的同时提供知识问答与文档摘要能力,部署周期约 2 周。
常见误区
误区“DeepSeek 是国产 API 服务,跟 ChatGPT 一样只能在线调用,本地没法部署。”
正解DeepSeek 模型权重以 MIT 协议开源,完整权重与蒸馏版都在 Hugging Face 官方账号发布,可用 vLLM、SGLang 或 Ollama 本地部署。区别在于全量 671B 需要多卡服务器,7B/32B 蒸馏版可在消费级显卡或单卡服务器运行。
为何常见:普通用户接触 DeepSeek 多从网页版或手机 App 开始,API 平台也强调“即开即用”,容易忽略开源权重这一核心资产。
误区“API 里的 deepseek-chat 就是某个 V3 版本,模型权重不会变。”
正解deepseek-chat 与 deepseek-reasoner 是模型别名,会随系列大版本升级自动更新指向(如 V3-0324、V3-0528 发布后 deepseek-chat 自动指向新版)。业务侧如需固定行为,需关注官方升级公告评估影响。
为何常见:OpenAI 的模型名(gpt-4o)本身带版本且更新频率低,用户把同样的命名习惯套到 DeepSeek 上。
误区“reasoner 只是比 chat 多一个思考过程,价格应该一样。”
正解DeepSeek API 对推理模型的思考过程(reasoning_content)按 token 计费,且 deepseek-reasoner 单价本身更高(输入 4 元 vs 2 元/M,输出 16 元 vs 8 元/M,截至 2025-05 以官网为准)。长思维链消耗大,成本敏感场景应先用 chat 试跑。
为何常见:产品界面中思考过程展示为“已深度思考”的独立区域,用户默认它是附加功能而非计费项。
误区“上下文 128K,让它输出一本 10 万字的书应该没问题。”
正解128K 是“输入 + 输出”的上下文窗口总长度,单次输出上限由 max_tokens 控制(默认 4K,上限 8K)。长输出必须显式调大 max_tokens,超长内容需分段多次调用再拼接。
为何常见:厂商宣传“128K context”强调模型可理解的长文本范围,用户混淆了“输入理解长度”与“输出生成长度”两个概念。
误区“都是 R1 模型,蒸馏版跑得快,效果应该和原版一样。”
正解蒸馏版(R1-Distill-Qwen/Llama 系列)是从 R1 输出中学习的小模型,在数学/代码任务上显著强于同尺寸通用模型,但官方报告明确其推理深度与复杂长链推理能力“接近”而非“等同”于 671B 原版。关键任务仍需以原版验证。
为何常见:官方宣传蒸馏版在 AIME 上高达 72.6%(32B 版)的准确率,用户看到高分数后忽略了其与原版的差距。
面试题
Q1. DeepSeek 开放平台 API 与哪套主流 API 格式兼容?
- A.OpenAI 接口格式← 正确答案
- B.Anthropic 接口格式
- C.Google Gemini 格式
- D.自有私有格式
答案:A。DeepSeek API 兼容 OpenAI 的 chat.completions 接口格式,可直接用 openai SDK 并通过修改 base_url 为 https://api.deepseek.com 完成调用,这是其生态易用性的核心设计。
Q2. deepseek-reasoner 对应的模型系列是?
- A.DeepSeek-V 系列
- B.DeepSeek-R 系列← 正确答案
- C.Qwen 系列
- D.Llama 系列
答案:B。deepseek-reasoner 是推理模型别名,指向 DeepSeek-R 系列(当前为 R1 及其更新版本);deepseek-chat 才指向 V 系列对话模型。
Q3. DeepSeek-V3 模型权重的开源协议是?
- A.Apache 2.0
- B.MIT License← 正确答案
- C.GPL-3.0
- D.仅限科研使用
答案:B。DeepSeek-V3 与 R1 权重均采用 MIT License,允许商用、修改与再分发。Qwen 使用 Apache 2.0,两者协议不同但都允许商用。
Q4. 下列哪个采样参数对 deepseek-reasoner 无效?
- A.max_tokens
- B.temperature← 正确答案
- C.stream
- D.messages
答案:B。官方文档明确说明 deepseek-reasoner 不支持 temperature、top_p 等采样参数,传参会被忽略或报错;max_tokens、stream、messages 正常生效。
Q5. DeepSeek-V3 的总参数量与单次激活参数量分别是?
- A.671B / 37B← 正确答案
- B.236B / 21B
- C.70B / 7B
- D.1000B / 100B
答案:A。DeepSeek-V3 是 671B 总参数的 MoE 模型,每次推理仅激活 37B 参数,这是其推理成本远低于同规模 Dense 模型的关键架构设计。
Q6. 使用单张 RTX 4090(24GB 显存)本地部署 DeepSeek 模型,以下哪项可行?
- A.部署 DeepSeek-V3 全量模型
- B.部署 R1-Distill-Qwen-7B← 正确答案
- C.部署 DeepSeek-R1 全量模型
- D.无法部署任何 DeepSeek 模型
答案:B。R1-Distill-Qwen-7B 在 FP16 精度下约需 14-16GB 显存,单张 24GB 显卡可运行;671B 全量模型需要多卡集群,消费级单卡不可行。
Q7. DeepSeek-V3 能以低成本推理的根本原因是什么?
- A.训练集规模更小
- B.MoE 稀疏激活与 MLA 缓存优化← 正确答案
- C.模型跳过了对齐训练
- D.移除了安全防护层
答案:B。MoE 每次推理仅激活 37B/671B 参数,降低计算量;MLA 技术压缩 KV 缓存、减少显存占用与带宽需求。两者叠加使单次推理成本大幅下降,与训练集大小、对齐训练无关。
Q8. DeepSeek API 目前支持以下哪些能力?
- A.Function Calling 函数调用← 正确答案
- B.JSON Output 结构化输出← 正确答案
- C.128K 上下文窗口← 正确答案
- D.图像视频多模态输入
答案:ABC。DeepSeek API 支持函数调用、JSON 输出与 128K 上下文。V3 与 R1 均为纯文本模型,不支持图像或视频输入,多模态需选择 Qwen-VL 等其他模型。
Q9. 关于 DeepSeek-R1 的蒸馏版本(R1-Distill),下列说法正确的是?
- A.基于 Qwen 与 Llama 系列蒸馏← 正确答案
- B.与原版 R1 推理能力完全一致
- C.可在消费级显卡部署← 正确答案
- D.仅支持中文一种语言
答案:AC。官方蒸馏版基于 Qwen2.5 与 Llama 系列,7B/14B/32B 等尺寸可在消费级显卡运行。蒸馏版推理能力“接近”但不等同于原版,且支持中英文等多语言,D 表述错误。
Q10. 生产环境使用 DeepSeek 官方 API 时,以下哪些是推荐做法?
- A.设置单日消费上限与用量告警← 正确答案
- B.长输出任务显式设置 max_tokens← 正确答案
- C.对用户输入做 PII 脱敏后再发送← 正确答案
- D.直接使用默认参数不做任何配置
答案:ABC。生产环境应设置消费上限防异常调用;max_tokens 默认 4K,长任务不设置会静默截断;用户输入可能含个人信息,调用前应脱敏。D 不做任何配置在真实生产环境不可取。
参考来源
- webpageDeepSeek 官网产品介绍、网页版与 App 下载入口