DeepSeek-v4 官方 API 集成 Dify

下面对第一种方式————进行手把手级细化，把所有操作拆解到每个界面点击、每个输入框内容，确保你能跟着一步不差地完成。：Cloud 云版 / 自部署 Community / Enterprise 版均通用。：约 5–8 分钟。：一个能收发邮件的邮箱，一个可正常访问 Dify 和 DeepSeek 的网络环境。

水上冰石

253人浏览 · 2026-05-09 06:14:49

水上冰石 · 2026-05-09 06:14:49 发布

下面对第一种方式——使用 DeepSeek 官方 API 集成 Dify——进行手把手级细化，把所有操作拆解到每个界面点击、每个输入框内容，确保你能跟着一步不差地完成。

适用 Dify 版本：Cloud 云版 / 自部署 Community / Enterprise 版均通用。
所需时间：约 5–8 分钟。
前置条件：一个能收发邮件的邮箱，一个可正常访问 Dify 和 DeepSeek 的网络环境。

🧭 整体流程概览

在 DeepSeek 开放平台注册账号并创建 API Key
登录 Dify，进入「模型供应商」添加 DeepSeek
填写 API Key、模型名称等参数并保存
创建应用并选择 DeepSeek 模型进行测试
常见排错与使用建议

① 获取 DeepSeek API Key

1.1 访问 DeepSeek 开放平台

打开浏览器，输入网址：
https://platform.deepseek.com/

如果你是第一次使用，会看到登录/注册界面。

1.2 注册账号

点击「注册」按钮（通常位于页面中下位置）。
填写你的邮箱地址。
设置一个密码，要求一般包含字母、数字，长度不少于 8 位。
勾选服务协议（请阅读后决定）。
点击「获取验证码」，收取邮件并填写 6 位数字验证码。
点击「注册」完成账号创建。

⚠️ 密码建议：避免纯数字或连续字符，尽量大小写混合+数字+符号。

1.3 进入 API Keys 管理

注册成功后会自动登录，你将进入 DeepSeek 控制台。

在左侧导航栏找到「API Keys」菜单（图标一般为一把钥匙）。
点击进入。

1.4 创建新的 API Key

在 API Keys 页面，点击橙黄色或蓝色的「创建新的 API Key」按钮。
系统要求你为此 Key 起一个名称（可选，但便于区分）。

示例名称：dify-production、test-key-01

点击「创建」，页面会弹出一段由字母和数字组成的字符串，即为你的 API Key。
🔐 立即复制并保存！关闭弹窗后该 Key 将不再完整显示，只能重置生成新 Key。
该 Key 可在 Dify 配置中使用。

💰 账户余额：新注册用户一般会获得一定免费额度，可在「Usage」页面查看。你可根据需求充值。

② 在 Dify 中添加 DeepSeek 模型供应商

2.1 登录 Dify 平台

如果使用 Dify Cloud：访问 https://cloud.dify.ai/，登录你的账号。
如果自行部署：访问你自己的 Dify 实例地址（例如 http://localhost:3000 或你的服务器域名），使用管理员账号登录。

2.2 进入「模型供应商」设置

登录成功后，你会在右上角看到自己的头像（或首字母缩写）。
点击头像，在下拉菜单中选择「设置」。
在设置页面的左侧竖栏中，点击「模型供应商」选项（英文界面为 “Model Provider”）。

2.3 找到 DeepSeek 供应商卡片

在模型供应商列表里，你会看到一系列预设的供应商卡片：OpenAI、Anthropic、Azure、当地部署……
向下滚动，找到 「DeepSeek」，卡片上通常会有 DeepSeek 的图标和名称。
如果找不到，可以在页面上方的搜索框中输入 “DeepSeek” 进行过滤。

2.4 开始配置 DeepSeek

将鼠标移到 DeepSeek 卡片上，卡片右侧会出现一个「设置」或「添加到列表」的按钮（通常是一个小齿轮或“+添加模型”文字）。
点击该按钮，会弹出配置小窗口。

③ 精细化填写配置参数

Dify 会要求你填写以下信息，请严格对照操作：

配置项	填写内容	说明
API Key	粘贴之前复制的 DeepSeek API Key	注意前后不要有空格。Dify 会自动校验 Key 的有效性。
API Endpoint	保持默认（一般无需填写）	默认指向 DeepSeek 官方 API 地址，如果你的网络有特殊代理需求，可参考后文排错。
模型列表	这一步通常会自动获取，无需手动填写。但你可以手动添加模型 ID	见下方「模型选择详解」。

3.1 关键：模型选择与正确名称

DeepSeek 官方 API 提供多个模型，在 Dify 中你需要根据任务类型选用不同的 model 名称。点击「保存」后，Dify 通常会拉取你账户可用的模型列表，你可以在下拉菜单中直接选择。如果没有自动出现，则可以手动添加：

推理 / 复杂任务模型：
适合数学、编程、逻辑分析等任务，具备更长的思维链能力。
模型名称填写：deepseek-reasoner
（也可能会显示为 deepseek-r1，以 API 文档最新名称为准）
对话 / 通用模型：
适合日常问答、内容生成、多轮对话等场景。
模型名称填写：deepseek-chat
（可能对应 V4 或 V3 系列）
如果你需要指定最新的具体版本（例如平台已支持 V4）：
查看 DeepSeek 官方文档的模型 ID，例如 deepseek-v4-pro、deepseek-v4-flash 等，在 Dify 模型供应商页面手动添加模型，填入对应 ID 即可。

✅ 操作建议：保存 Key 后，若自动出现模型列表，则勾选你需要的模型前的复选框，然后点击“保存”，这些模型就会出现在应用编排的下拉选择中。

④ 创建你的第一个 DeepSeek 应用并测试

4.1 从首页创建应用

在 Dify 顶部导航栏点击「工作室」或「应用」图标，回到主页面。
点击右侧显眼的「创建空白应用」按钮。

4.2 选择应用类型

会弹出一个小窗口，让你选择：

「聊天助手」：一问一答式对话，适合客服、问答机器人。
「文本生成应用」：适合一次性生成文章、摘要等。
「Agent」：能调用工具、知识库的高级智能体。
「工作流」：以画布编排复杂流程。

建议首次测试选择「聊天助手」，最直观方便。
输入应用名称（例如 “DeepSeek测试”），点击「创建」。

4.3 配置 LLM 节点选择 DeepSeek 模型

应用创建后会自动进入编排界面，左侧是配置区域，右侧是实时预览框。
在“模型设置”区域（一般在页面上方或左侧），找到 “模型” 下拉菜单。
点击下拉，你应该能看到之前添加的 DeepSeek 模型（例如 deepseek-reasoner、deepseek-chat）。
选择你想要的模型，比如 deepseek-chat。

如果你之前手动添加了多个模型，这里会列出你勾选的所有模型，选择其中一个即可。

4.4 调整模型高级参数（可选）

下方通常有参数滑动条或文本框：

温度 (Temperature)：控制随机性，0 最确定，1 最具创造性。初次测试可设为 0.7。
Top P：核采样，一般默认 1 即可。
最大 Token 数：设定回复的最大长度，如果没有特殊要求，可以不设置（默认为无限制或模型上限）。

4.5 填写系统提示词（必须为空！）

⚠️ DeepSeek 官方建议，对于 deepseek-reasoner 或 deepseek-chat，系统提示词 (System Prompt) 保持为空可以发挥模型最佳性能。

找到“系统指令”（System Prompt）文本框，确保里面没有内容。
如果你确实需要指示模型扮演特定角色，请使用简短的提示词，并尽量使用 User 角色下发言。例如：

你是一个 Python 编程专家，请用简洁的代码回答问题。

4.6 测试对话

在右侧的预览框中，输入一句测试消息，例如：“请介绍一下你自己，并写一个快速排序的 Python 实现。”
按 Enter 发送，稍等片刻就能看到 DeepSeek 返回的内容。
如果返回正常，说明集成成功！

⑤ 排错指南与高频问题

问题现象	可能原因	解决办法
Dify 提示“API Key 无效”	Key 复制不完整或已过期；Key 没有正确粘贴到 DeepSeek 供应商卡片而是其他卡片	重新到 DeepSeek 平台生成新 Key，再次粘贴。检查是否误点到其他供应商。
模型保存后，下拉列表为空	自动获取模型列表失败（网络或权限问题）	手动在 DeepSeek 供应商配置页点击“添加模型”，填写模型 ID：`deepseek-chat`，保存后再回到应用刷新页面。
测试时返回“请求超时”	网络连接 DeepSeek API 较慢，或被防火墙拦截	检查是否有代理。在 Dify 的 `docker-compose.yaml` 或环境变量中设置 `HTTP_PROXY`；或联系管理员开通白名单。
返回内容为中文乱码或不连续	Token 截断导致	适当调大“最大 Token 数”参数；或者检查提示词是否有过多限制。
返回格式非常冗长，包含大量思考过程	选用了 `deepseek-reasoner` 模型，该模型会输出推理过程	这是正常现象，你可以在应用设置中打开“隐藏思考过程”开关，或者改为使用 `deepseek-chat` 模型。
提示“余额不足”	DeepSeek 账户免费额度用尽或欠费	登录 platform.deepseek.com 查看 Usage，并充值。

⑥ 正式使用的优化建议

开启 Dify 的“对话变量”与“知识库”：在应用编排界面，你可以在提示词中定义变量，让用户在对话中动态输入；也可以绑定知识库，实现基于私有文档的问答，无需修改模型本身。
利用 Dify 的日志与标注：每一次对话都会记录在左侧“日志与标注”中，你可以对不满意的回答进行修改标注，逐步优化提示词。
API 负载均衡：如果你的应用并发很高，可在“模型供应商”→“DeepSeek”中配置多个 API Key，Dify 会自动轮询，避免单 Key 限流导致服务中断。

现在，你已经完成了 DeepSeek 官方 API 与 Dify 的深度集成，可以开始搭建你自己的 AI 应用了。如果在某个具体步骤卡住（比如某页面按钮没显示），可以补充截图或详细描述，我来帮你进一步诊断。