接入指南

Dify

开源的 LLM 应用开发平台,可视化编排 Agent、工作流与 RAG。它通过 OpenAI-API-compatible 供应商接入任意 OpenAI 兼容服务,填好地址和密钥就能把 XylemNode 当作模型源。

官网 / 下载
  1. 01

    准备 Dify

    用 Dify Cloud(cloud.dify.ai)注册即可直接开用;或自托管——克隆官方仓库后用 Docker Compose 起服务,浏览器打开本地地址登录。

  2. 02

    安装 OpenAI-API-compatible 供应商

    进入右上角 设置 → 模型供应商,在列表或插件市场里找到并安装 OpenAI-API-compatible。它专门用来对接各类 OpenAI 兼容端点。

  3. 03

    添加 XylemNode 模型

    在该供应商卡片上点「添加模型」,按下表填写。API endpoint URL 要带 /v1,模型名要和后台一致。

    模型类型
    LLM
    模型名称
    gpt-5.6-sol
    API Key
    sk-你的密钥
    API endpoint URL
    https://api.xylemnode.com/v1
  4. 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。