Dify 怎么接第三方 API？模型供应商配置与应用选模
Dify 接入第三方 API，要先配置正确的模型供应商插件与模型凭据，再到应用的 LLM 节点选择这个模型，最后检查用户输入是否真正送达、结果是否真正返回。供应商验证通过，只完成了接入的一部分。本文按 2026 年 10 月 25 日的官方文档和插件源码整理，未登录 Dify 或联调云岚API。
先分清：你要让谁调用谁？
| 任务 | 调用方向 | 使用的凭据 |
|---|---|---|
| Dify 应用使用第三方模型 | Dify → 模型供应商 | 供应商签发的 API Key |
| 自己的网站调用 Dify 应用 | 网站后端 → Dify 应用 | Dify 应用 API Key |
本篇解决第一行。供应商 Key 填入模型配置；Dify 应用 Key 用于调用已发布的应用接口，两者不能替换。模型供应商说明、应用接口鉴权
名称相近的插件也可能方向相反：官方仓库的 models/openai_api_compatible 是模型供应商插件；extensions/openai_compatible 则把 Dify 应用接口转换成 OpenAI 兼容接口。不要只看到“OpenAI Compatible”就安装。模型插件、应用扩展说明
准备模型配置，别把显示名称当上游模型名
当前 Dify Cloud 文档的入口是 Integrations → Model Provider，由工作区所有者或管理员管理。先检查供应商插件是否已经安装，再配置模型；自部署或旧版本的菜单名称可能不同。官方配置入口
对照供应商文档，把这些项目逐项写清：
| 项目 | 应确认什么 |
|---|---|
| 插件与版本 | 是模型供应商插件，记录实际安装版本 |
| 模型类型 | 文本生成任务选择 LLM，不是 Embedding 或 Rerank |
| 模型名称 | Dify 中登记的名称；初次接入可直接使用已确认的上游模型 ID |
| 显示名称 | display_name 用于界面展示，不能据此判断请求了哪个模型 |
| 上游模型名称 | 有 endpoint_model_name 时，核对该覆盖值与服务接受的 ID |
| API Base URL | 使用该插件需要的基础地址，不自行混入完整操作路径 |
| 凭据与协议 | Key 属于目标供应商；API 类型与目标端点一致 |
当前官方插件配置包含 Chat Completions 与 Responses 的 API 类型选项；用户实际安装版未必具有相同选项。mode 的 Chat/Completion 与 API 类型也不是同一个设置。不要依据界面上一个“Chat”标签推断它一定请求 /responses。插件字段定义
需要排查地址拼接时看 Base URL 与协议教程。上下文上限、最大输出和功能开关，应按该模型与渠道的实际能力设置，表单默认值不等于模型能力。
保存或验证凭据可能触发模型请求，不能把它当作完全离线的格式检查。当前插件部分验证路径会发送短消息，流式验证路径也可能只读取首块；这不能证明长回答、完整流或业务任务都成功。凭据验证实现
到应用里明确选模，并连好输入与输出
先用一个最小 Workflow：User Input → LLM → Output。
- 在 User Input 定义文本变量，例如
source_text。 - 打开 LLM 节点，明确选择刚配置的供应商和模型。若采用模型环境变量，检查该变量实际指向；不要只修改工作区默认模型就假设所有节点都会切换。
- 在提示词编辑器通过变量选择器插入
source_text，确认引用来自正确的输入节点，而不是把变量名写成普通文字。 - 在 Output 中把结果变量绑定到 LLM 的文本输出。Chatflow 使用 Answer 节点返回内容，不能机械照搬 Workflow 的末节点。
模型和提示词在 LLM 节点配置；结果是否送回调用者还取决于输出连接。当前 Workflow 可以运行而不配置 Output，但相关分支不会向调用者返回数据。LLM 节点、Output 节点
用两份短输入，检查一次完整应用流程
先写出任务判据，再运行。下面是供读者自行测试的合成材料，不是实测记录：
| 输入 | 任务与预期 |
|---|---|
| 订单青竹17，约定周三发货 | 只返回订单标记和发货日；应保留青竹17、周三 |
| 订单白鹭28，约定周五发货 | 同一任务；应改为白鹭28、周五 |
第一份检查连通，第二份检查变量是否更新。若回答仍包含第一份内容，查看节点本次实际输入、提示词绑定及历史上下文；不要只反复更换 Key。
在编辑器的 Run History 或节点 Last run 检查输入、输出、错误与执行路径。确认确实执行了预期 LLM 节点，而不是错误分支或固定回复。试运行记录
需要对外使用时，再发布当前配置，并从实际使用入口复核一次。发布会更新线上应用，应在准备好后进行；Workflow、Chatflow 的编辑器测试不进入应用 Logs，正式 Web App/API 使用才在那里查看。发布说明、应用日志范围
下载 Dify 接入检查包，按配置、试运行、发布入口分别记录。CSV 保持空白，不存 Key；“尚未验证”不能填成成功。费用以实际供应商账单为依据，Dify 配置中的名称或估算不替代费用对账。
常见问题
供应商验证通过，应用还是报错，先看哪里？
先看失败节点及本次输入。确认应用选中了正确模型、模型名与参数一致，再检查输出连接；把凭据验证结果与应用执行结果分开记录。
改了显示名称，就等于换了模型吗？
不等于。核对 Dify 登记名称、上游模型覆盖值和 LLM 节点选择。界面别名只方便辨认，模型自称也不能代替这些配置证据。
打开结构化输出，就一定能返回合格 JSON 吗？
不一定。Dify 对不具备原生支持的模型可能通过提示词携带结构要求。先确认模型与插件能力，再按 JSON 三层检查方法检查语法、字段与内容，不能把开关当保证。官方能力说明
云岚API的 Key 和 Dify 应用 Key 能共用吗？
不能互换。已有云岚API账号先在控制台确认目标端点、模型 ID 与可用参数，再配置供应商凭据；首次接入先看新手教程。Dify 应用 Key 留给调用 Dify 应用的后端使用，本文不承诺所有渠道支持插件的全部功能。