Dify 接入

适用场景

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

推荐把天池 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 文档