Getting Started with DeepSeek

Start your DeepSeek journey. From web chat to API and local deployment. Step-by-step guide for beginners.

DeepSeek 入门指南

从第一次对话到生产部署 — 您的完整入门指南

DeepSeek 入门

按照以下步骤开始使用 DeepSeek 模型 — 从云 API 到本地部署

选择路径：云 API 还是本地部署

决定如何使用 DeepSeek。云 API 免费开始，无需特殊硬件。本地部署保护隐私，但需要足够性能的 GPU。

云端：在 chat.deepseek.com 注册（免费）
本地：先检查 GPU 显存
API：在 platform.deepseek.com 创建账户

先在网页端体验

访问 chat.deepseek.com 并注册，免费使用当前的 DeepSeek 模型，可以切换深度思考。2026年9月起，网页与 App 把快速、专家、识图几个模式合并到了一起（多家媒体报道），不必再单独找专家模式。无需信用卡。

复杂任务打开深度思考
API 端思考模式默认开启，默认强度是 high
支持网页搜索和代码执行

获取 API 密钥

前往 platform.deepseek.com，创建 API 密钥并充值少量余额（$5 足够）。API 兼容 OpenAI 格式 — 使用 openai Python SDK。

将密钥存储在环境变量中
从 deepseek-flash 开始（最便宜，还能传图）
在计费面板监控使用量

安装 Ollama 用于本地使用

从 ollama.com/download 下载 Ollama。支持 macOS、Windows 和 Linux，一键安装。先拉取 deepseek-r1:7b 等小模型测试。

从 7B 模型开始测试
使用 ollama pull deepseek-r1:7b
使用 ollama run deepseek-r1:7b 运行

掌握 API 使用

DeepSeek API 支持思考模式、函数调用、JSON 模式、图像输入和流式传输。用 reasoning_effort（low / high / max）控制推理深度，用 thinking 参数开关思考。上下文缓存可节省重复前缀的成本。

缓存命中比未命中便宜约 98%
max_tokens 最高 384K
把跑批挪到低峰，价格是高峰的一半

生产最佳实践

生产环境：实现重试逻辑、监控令牌使用量、利用上下文缓存。默认选 deepseek-flash —— 按官方评测表，它在智能体与编码类基准上已超过 V4-Pro，价格还低得多；只有在需要更强的世界知识问答（GPQA、HLE）或要与既有 V4-Pro 行为对齐时才用 V4-Pro。

监控缓存命中率
实现指数退避重试
模型名、价格、上下文上限都以官方页面为准，别写死在代码里

常见问题

FAQ

DeepSeek 部署和使用过程中常见问题的解决方案

V4.1-Flash 和 V4-Pro 有什么区别？

两个都在 API 里可调用。deepseek-flash 自 2026年10月17日起对应 DeepSeek-V4.1-Flash-1017：552B 骨干参数的 MoE，prefill 约激活 8B、decode 约 16B，原生支持图像输入；按官方评测表，它在 Terminal-Bench、DeepSWE、NL2Repo、ProgramBench 这些智能体与编码项上已超过 V4-Pro，并发上限 2500。deepseek-v4-pro 对应 DeepSeek-V4-Pro-0813：1.6万亿参数、490亿激活，不支持图像，但世界知识类题目更高（GPQA 92.4、HLE 42.7），并发上限 500。两者上下文都是 100万令牌，输出上限 384K，换版后价格一个数字都没动。

现在该用哪个模型名调用 API？

新接入只用两个名字：deepseek-flash（默认推荐）和 deepseek-v4-pro。deepseek-v4-flash、deepseek-v4-flash-vision-exp 仍会被接受，但这两个模型已于 2026年9月10日退役，请求实际由 V4.1-Flash 服务并按 Flash 单价计费。更早的 deepseek-chat、deepseek-reasoner 已于 2026年7月24日停用。

如何在 API 里传图片？

只有 deepseek-flash 支持视觉，deepseek-v4-pro 不支持。按 OpenAI 兼容格式把 content 写成数组，用 image_url 携带 data:image/...;base64,... 的图片。支持 JPEG、PNG、GIF、WebP；格式是按实际文件内容判断的，不看扩展名也不看声明的 MIME 类型。单次请求体上限 48 MiB。

如何在 API 中启用思考模式？

思考模式默认就是开启的，默认强度为 high。用 extra_body={"thinking": {"type": "disabled"}} 关闭它；用 reasoning_effort 取 low / high / max 来调档。推理过程在响应的 reasoning_content 字段里，与 content 同级。

API 现在是怎么计费的？

三种令牌桶：输入缓存命中、输入缓存未命中、输出。Flash 每百万令牌低峰为 $0.003 / $0.15 / $0.60，高峰翻倍到 $0.006 / $0.30 / $1.20；V4-Pro 低峰 $0.022 / $0.66 / $1.98，高峰 $0.044 / $1.32 / $3.96。高峰时段是周一至周五 01:00–04:00 与 06:00–10:00（UTC），中国法定节假日不计入高峰，周末整段按低峰算。

我可以在本地运行 V4.1-Flash 吗？

权重是开源的（MIT，仓库 deepseek-ai/DeepSeek-V4.1-Flash-1017，旧的 DeepSeek-V4.1-Flash 仓库也还在），但体积约 510.3GB，官方随仓库提供的参考实现要按 8 路张量并行转换权重，它是能读懂的参考代码而不是生产服务引擎。1017 这一版还不附带 Jinja 对话模板，提示词编码得自己按仓库里的 encoding/ 参考实现接，或者用官方的 deepseek-recipe。Ollama 上只有 deepseek-v4.1-flash:cloud 这一个云端标签，而且它没有跟着 10 月 17 日更新，也没有可以直接 pull 的本地量化版。要在自己机器上跑，现实选择仍是 R1 蒸馏系列（7B / 8B / 14B / 32B / 70B）。

DeepSeek API 是否与 OpenAI SDK 兼容？

是的，与 OpenAI 的 Chat Completions 格式完全兼容，把 base_url 改成 https://api.deepseek.com 就行。另外还有 Anthropic 兼容端点 https://api.deepseek.com/anthropic，以及 OpenAI Responses API 格式。

如何在 DeepSeek 中使用函数调用？

DeepSeek 在思考和非思考模式下都支持 OpenAI 兼容的函数调用，用标准格式声明工具即可。注意上下文规则：请求带 tools 参数时，各轮的 reasoning_content 要一起回传，它才会被拼进上下文；不带 tools 时不需要回传，即使传了也会被忽略。

为什么 API 成本比预期高？

最容易漏的是缓存未命中那个桶：每条新的用户消息都算未命中，把稳定的系统提示和工具定义放在前面能明显提高命中率（命中便宜约 98%）。其次是时段——高峰价格正好是低峰的两倍，跑批可以挪到低峰或周末。

思考模式里还能调 temperature 吗？

不能。思考模式下 temperature、presence_penalty、frequency_penalty 都不生效（设了不报错，但也没有作用），top_p 只在 0.95–1.0 之间有效，低于 0.95 按 0.95 处理；非思考模式下 top_p 固定为 1.0，传什么都会被忽略。官方推荐的采样参数是 temperature=1.0、top_p=0.95 或 1.0。