Dify 接入第三方 API 快速教程：配置 OpenAI 兼容模型供应商
在 Dify 中安装 OpenAI-API-compatible 模型供应商，填写第三方 API 的 Base URL、API Key 和模型名称，快速跑通应用调用。
Dify 支持通过 OpenAI 兼容供应商接入第三方模型服务。NixAPI 提供统一的 OpenAI 兼容接口，因此你可以在 Dify 中添加 NixAPI，供聊天应用、Agent 应用和 Workflow 节点调用。
这篇教程用最短路径跑通：创建 Key，添加模型供应商，填写 Base URL 和模型名，最后在 Dify 应用里测试。
准备工作
你需要：
- 一个可登录的 Dify 控制台
- 一个 NixAPI API Key
- 一个要测试的 Dify 应用或工作流
如果还没有 NixAPI API Key，打开 NixAPI 控制台 创建。模型列表和价格可以在 NixAPI 模型价格页 查看。
第一步：确认 NixAPI Base URL
Dify 的 OpenAI 兼容供应商里，Base URL 填写：
https://nixapi.com/v1
这个地址兼容 OpenAI API 格式。Dify 后续会基于这个地址调用 chat/completions、embeddings 等接口。
不要填写 https://api.openai.com/v1，否则请求会走官方接口；也不要漏掉 /v1。
第二步：安装 OpenAI 兼容供应商
登录 Dify 后台，进入：
设置 → 模型供应商
找到 OpenAI-API-compatible 或类似名称的供应商插件。如果提示安装或更新，按页面提示安装最新版。
安装完成后，点击添加模型。
第三步：填写模型配置
在模型配置页面填写：
| 字段 | 示例值 | 说明 |
|---|---|---|
| API Key | nix-your-api-key | 从 NixAPI 控制台复制 |
| Base URL | https://nixapi.com/v1 | NixAPI OpenAI 兼容接口 |
| 模型名称 | claude-sonnet-4-20250514 | 你要在 Dify 中使用的模型 |
可以先添加这些模型之一：
claude-sonnet-4-20250514gpt-5.4gemini-3-pro-previewdeepseek-v4minimax-m3
模型名必须和 NixAPI 支持的 ID 一致。建议从 NixAPI 支持的模型列表页 复制。
保存后，Dify 通常会自动做连通性检测。如果检测失败，不要急着改应用，先检查 Key、Base URL 和模型名。
第四步：在应用中测试
打开一个已有聊天应用，或新建一个测试应用。在模型选择处选中刚刚添加的 NixAPI 模型。
输入：
帮我把下面这句话改写得更正式：今天先把接口联调跑通。
如果 Dify 正常返回结果，说明模型供应商配置成功。
你也可以在调用日志中看到类似请求：
POST https://nixapi.com/v1/chat/completions
Authorization: Bearer nix-your-api-key
这说明 Dify 的模型调用已经走到 NixAPI。
第五步：在 Workflow 中使用
如果你使用 Dify Workflow，可以在 LLM 节点里选择刚配置的 NixAPI 模型。
常见用法：
- 用户提问 → 知识库检索 → NixAPI 模型总结
- 表单输入 → NixAPI 模型生成结构化 JSON
- HTTP 请求节点获取数据 → NixAPI 模型生成报告
如果工作流涉及长文本或多轮调用，建议先查看 NixAPI 模型价格页。NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。
可选：配置 Embeddings 模型
如果你的 Dify 应用需要知识库检索，还可以用同样的 OpenAI 兼容供应商添加 embeddings 模型。配置方式类似：
| 字段 | 示例 |
|---|---|
| API Key | nix-your-api-key |
| Base URL | https://nixapi.com/v1 |
| 模型名称 | 以 NixAPI 支持的 embeddings 模型为准 |
添加后，在知识库设置中选择该 embeddings 模型即可。
常见问题
1. 401 Unauthorized
API Key 错误或未正确带上 Bearer 认证。重新从 NixAPI 控制台 复制 Key，并确认 Dify 的供应商配置保存成功。
2. 请求超时
先确认 Base URL 是否为：
https://nixapi.com/v1
如果 Dify 部署在服务器上，也要确认服务器能访问该地址。
3. JSON 解析错误
通常和应用提示词或响应格式有关。先用普通聊天模式测试模型是否正常，再逐步打开 JSON mode、结构化输出或函数调用。
4. 模型名报错
模型 ID 不存在或拼写错误。到 NixAPI 支持的模型列表页 复制准确名称。
小结
Dify 接入 NixAPI 的关键配置是 OpenAI-API-compatible 供应商、https://nixapi.com/v1、NixAPI API Key 和准确模型 ID。配置完成后，聊天应用、Agent 应用和 Workflow 都可以复用这套模型能力。