Dify 接入

适用场景

Dify 是应用搭建、工作流和 Agent 编排平台。把天池 Token 接入 Dify 后，可以在聊天应用、Workflow、Agent 和知识库流程中使用平台模型。

如果你的 Dify 环境可以访问插件市场，优先安装 Skypool 插件直接使用；如果无法安装插件，再按 OpenAI 兼容供应商手动接入。

方式一：安装 Skypool 插件直接使用（推荐）

Skypool 插件已经上架 Dify Marketplace：

• 打开 Skypool 插件市场页

Skypool 插件会以模型供应商的形式接入 Dify。安装后可以直接选择预置的 Skypool 聊天模型，并继续使用 Dify 的流式输出、工具调用和 Workflow / Agent 编排能力。

安装插件

1. 打开 Dify 工作空间。
2. 进入 Plugins 或 Marketplace，搜索 Skypool；也可以直接打开上面的插件市场链接。
3. 点击 Install，选择要安装到的工作空间。
4. 安装完成后，在 Dify 的模型供应商或插件配置页找到 Skypool。

配置凭据

如果你使用的是私有部署或测试环境，才需要把 Endpoint URL 改成对应的 Skypool-compatible 地址。不要填写完整的 /chat/completions 路径。

在 Dify 应用中使用

1. 创建或打开一个 Chat App、Workflow 或 Agent。
2. 在模型选择器中选择 Skypool 供应商下的模型。
3. 保存应用配置后，先用简单消息验证模型是否能正常返回。

首次测试建议先创建一个最简单的 Chat App，并发送：

请用一句话说明当前应用已经通过 Skypool 插件接入成功。

方式二：OpenAI 兼容供应商手动接入

这条路径适合暂时不能安装插件、需要在 Dify 的模型供应商页手动配置，或需要兼容旧版 Dify 的场景。

推荐把天池 Token 配成 Dify 的 OpenAI 兼容供应商：

在 Dify 中添加模型供应商

进入 Dify 工作空间，按以下路径配置：

1. 打开 Settings。
2. 进入 Model Providers。
3. 选择 OpenAI，如果你的版本提供 OpenAI-API-compatible，也可以选择它。
4. 添加一组新的凭据。
5. API Key 填写 Consumer API Key。
6. Custom Base URL 或 API Base 填写 https://a.skypool.xyz/v1。
7. 保存并测试连接。

Dify 会在保存时验证凭据。验证失败时，先用同一个 Key 和模型执行本文末尾的 curl，确认平台侧调用已经可用。

添加或选择模型

如果 Dify 的模型列表里没有天池 Token 的模型 ID，需要手动添加自定义模型。

建议字段如下：

添加后，在应用的模型选择器中选择对应模型。

在应用中使用

创建或打开一个 Dify App，在模型配置里选择刚刚接入的天池 Token 模型。建议先用最简单的 Chat App 测试：

请用一句话说明当前应用已经接入天池 Token。

测试通过后，再用于 Workflow、Agent、工具调用或知识库问答。

验证接口

如果 Dify 配置失败，先在终端验证同一个 Key 和模型：

curl -X POST "https://a.skypool.xyz/v1/chat/completions" \  -H "Authorization: Bearer <consumer_api_key>" \  -H "Content-Type: application/json" \  --data-raw '{    "model": "gemma4:26b",    "messages": [      {        "role": "user",        "content": "请返回一句简短的接入成功提示。"      }    ],    "max_tokens": 64,    "stream": false  }'

排查清单

参考资料

• Dify 官网
• Dify Model Providers 文档