接入指南
Dify
开源的 LLM 应用开发平台,可视化编排 Agent、工作流与 RAG。它通过 OpenAI-API-compatible 供应商接入任意 OpenAI 兼容服务,填好地址和密钥就能把 XylemNode 当作模型源。
- 01
准备 Dify
用 Dify Cloud(cloud.dify.ai)注册即可直接开用;或自托管——克隆官方仓库后用 Docker Compose 起服务,浏览器打开本地地址登录。
- 02
安装 OpenAI-API-compatible 供应商
进入右上角 设置 → 模型供应商,在列表或插件市场里找到并安装 OpenAI-API-compatible。它专门用来对接各类 OpenAI 兼容端点。
- 03
添加 XylemNode 模型
在该供应商卡片上点「添加模型」,按下表填写。API endpoint URL 要带 /v1,模型名要和后台一致。
- 模型类型
LLM- 模型名称
gpt-5.6-sol- API Key
sk-你的密钥- API endpoint URL
https://api.xylemnode.com/v1
- 04
保存并使用
保存后可在右上角「系统模型设置」把默认推理模型设为它;之后在应用编排里就能选到 XylemNode 的模型。
两点说明
① 若要做知识库 / RAG,需在同一供应商下再加一个 Embedding 模型(模型类型选 Text Embedding),并在知识库里设为默认。 ② 部分新版 Dify 也可直接用内置 OpenAI 供应商、把 base URL 改成 XylemNode 的 /v1 地址,效果一样;按你的版本选顺手的即可。
常见问题
Dify 的模型供应商列表里找不到「OpenAI-API-compatible」?
Dify 1.x 起模型供应商改成了插件,要先去 Marketplace 安装对应插件,它才会出现在供应商列表里——这一步没做的话,列表里空着是正常的,不是你装错了版本。装好后按自定义模型的方式填模型名和 Base URL 即可。另外提醒一个 Dify 侧的已知兼容问题:对于要求 max_completion_tokens 的新式模型,Dify 的 OpenAI 兼容实现仍然发送 max_tokens,因此上游可能因参数不被接受而报错——这属于 Dify 本身待修的部分,遇到这类参数报错时先不要在 Dify 里限制最大 token。