XylemNode

接入指南

Coze Studio（扣子开源版）

扣子的开源自托管版本，可视化搭建 AI Agent 与工作流。它的模型服务支持「第三方 API 中转」，协议选 openai、填带 /v1 的地址即可接入 XylemNode。

获取 API Key
官网 / 下载
  1. 01

    部署开源版 Coze Studio

    扣子云平台（coze.cn / coze.com）用的是平台托管模型，接不了自定义端点；能接 XylemNode 的是开源版 Coze Studio。按官方文档克隆仓库、用 Docker Compose 部署起来。

  2. 02

    打开模型管理

    浏览器进入管理后台的模型管理页，点新增模型。

    模型管理地址
    http://localhost:8888/admin/#model-management
  3. 03

    按第三方中转填写

    XylemNode 属于「其他第三方 API 中转」：协议选 openai，接入地址填带 /v1 的域名（不要带 /chat/completions），再配上密钥和模型名。

    协议 / Protocol
    openai
    Base URL
    https://api.xylemnode.com/v1
    API Key
    sk-你的密钥
    模型名
    gpt-5.6-sol
  4. 04

    保存并选用

    保存后，模型 ID 全局唯一、上线后别再改（改了会导致调用失败）。之后创建 Agent 或工作流时就能选到这个模型。

两点说明

① 仅开源版 Coze Studio 支持这样接入；扣子云平台不支持自定义 OpenAI 兼容端点。 ② 若用 Docker 部署且模型服务在宿主机，容器内的 localhost 不等于宿主机，需改成宿主机 IP 或 host.docker.internal；XylemNode 是公网地址则不受影响。

常见问题

Coze Studio 创建 Agent 时模型下拉是空的？

开源版不带可用模型，官方文档明确要求部署后先把模型服务配好，否则创建 Agent 或工作流时选不到模型。到 /admin/#model-management 新增一个：协议选 openai，接入地址填到带 /v1 的层级、不要带 /chat/completions——这正是官方给「其他第三方 API 中转」的填法。还有两条官方注意事项建议先看：模型 ID 上线后不要再改，Agent 和工作流都是按模型 ID 调用的，改了会导致调用失败；删除模型前先确认它已经没有线上流量。