Dify 怎么接入 DeepSeek？配置模型供应商并验证首次回答

Dify 接入 DeepSeek 的起点是配置模型供应商：安装 DeepSeek 模型插件，填写自己的 DeepSeek API Key，再让应用中的 LLM 节点使用该供应商下的模型。接通后，用一条固定问题检查节点输入、输出和调用错误，比直接搭建复杂智能体更容易定位问题。

本文面向已有 Dify 工作空间、希望使用 DeepSeek 官方 API 的读者。操作依据核对于 2026 年 10 月 1 日，采用当前 Dify Cloud 文档；自部署实例、旧版本和已安装插件的界面可能不同。本文未在读者的 Dify 实例上实测，测试输入及判定标准是演示用例。

先分清两种密钥和一个模型名称

先登录 DeepSeek 官方平台，在 API Keys 页面创建密钥，并确认 API 账户可用。Dify 官方插件的 供应商配置文件将密钥入口列为 https://platform.deepseek.com/api_keys；该控制台需要你的登录身份。Dify 官方说明指出，只有工作空间所有者和管理员可以管理模型供应商，配置的密钥会在工作空间内使用；参见 模型供应商文档。如果你看不到供应商设置，先检查工作空间角色。

当前 DeepSeek 首次 API 调用文档列出的示例模型是 deepseek-flash；Dify 官方插件仓库也包含对应的 模型配置文件。这说明当前文档和插件源代码的名称一致，不代表你的旧插件已经同步更新。操作时以已安装插件实际展示、官方当前仍支持的模型为准，别照抄过时教程里的模型代号。

第一步：安装供应商并验证凭证

1. 进入 Dify 工作空间的 Integrations → Model Provider，查找 DeepSeek；如果未安装，进入模型供应商安装列表或 Marketplace，安装对应供应商插件。
2. 在 DeepSeek 卡片上点击 Setup，将 DeepSeek API Key 填入插件要求的凭证字段，保存。Dify 会先检查凭证。
3. 确认供应商可以使用，并查看它提供的模型列表。如果当前需要的模型不在列表中，先检查插件版本和插件的模型清单；有些供应商只有预定义模型，没有 Add Model 入口，不能把“手动添加”当成必然存在的选项。

这一步通过，验证的是供应商凭证可用；还要在具体应用里选择模型。不要把 DeepSeek 密钥填成 Dify 应用密钥，也不要把 API Key 写进 System 提示词、普通输入字段或公开页面。

如果你使用的是官方 DeepSeek 供应商插件，优先按该插件表单配置。DeepSeek 官方 OpenAI 兼容接口地址为 https://api.deepseek.com，但这里不需要为了“接入”再搭一套本地模型，也不应在没有相关字段的表单里寻找或强行填写 Base URL。

第二步：建一个只有三步的验证应用

新建 Workflow 应用，保留用户输入节点，增加一个 LLM 节点，再连到 Output 节点。当前文档中 Output 旧称 End；不同版本的名称可能不同。配置方法参见 LLM 节点和 Output 节点。

1. 在用户输入节点新增一个必填的 Paragraph 字段，变量名设为 question。
2. 在 LLM 节点选择 DeepSeek 供应商，再选当前可用模型，例如插件中已列出的 deepseek-flash。
3. System 填入下面的固定规则；User 消息用变量选择器插入上游的 question，不要手打一个没有绑定来源的变量名。
4. 在 Output 新增输出字段 answer，来源选该 LLM 节点的 text。

你是接口连通性测试助手。
只按用户要求完成简单转换，不解释，不补充事实。
如果输入要求提取值，只返回该值。

Workflow 中的 Output 字段决定调用者能拿到什么结果。工作流可以执行成功却没有对外输出；因此“节点跑了”与“页面看到答案”需要分别核对。

第三步：用固定问题核对首次回答

在预览里给 question 输入下面这句话：

从“测试编号：DS-CONNECT-27”中提取编号，只输出 DS-CONNECT-27。

本例的目标输出是 DS-CONNECT-27。运行后检查三个地方：LLM 节点输入确实收到完整测试句；节点输出不是错误而是编号；最终输出中的 answer 与节点 text 一致。

如果回答加了说明或换行，供应商连接可能已经成功，问题主要在提示词遵循；如果节点失败并返回认证、额度或模型错误，应先处理模型接入。不要把“内容没严格按格式”误判成“API Key 无效”。

确认小流程通过后，再把相同供应商和模型配置到正式工作流里的 LLM 节点。若正式应用使用 Agent 或工具调用，还需要检查模型和策略的兼容性；本次纯文本验证不证明工具调用、视觉输入或知识库检索已经可用。

失败时按症状排查

Dify 的 错误处理文档区分了供应商未初始化、供应商额度耗尽、模型不支持和请求错误。记录错误码、节点名和时间，能帮助管理员找准层级；不要把密钥或完整私人输入发到公开讨论区。

接入后还有两个常见疑问

接上 DeepSeek 就能为知识库生成向量吗？

不能据此推断。Dify 将一般推理模型与 Embedding、Rerank 等模型分开配置；本教程验证的是 LLM 文本调用。建库前仍要确认自己的 Embedding 供应商和模型已配置，不要把 LLM 连接成功当成向量索引准备完毕。

这是在电脑上安装 DeepSeek 吗？

不是，本教程使用 DeepSeek 官方在线 API，Dify 负责组织输入与输出。即使 Dify 是自部署的，调用在线模型也不代表模型在本机运行；需要本地推理时，应另行选择本地模型服务和相应供应商配置。