接入指南

Cherry Studio

跨平台开源桌面 AI 客户端(Windows / macOS / Linux),一个界面聚合多家模型。加一个 OpenAI 类型的自定义供应商,就能把 XylemNode 接进来。

官网 / 下载
  1. 01

    安装

    到 Cherry Studio 官方仓库 / 官网下载对应系统的安装包,装好并打开。

  2. 02

    新建 OpenAI 类型供应商

    进入 设置 → 模型服务,点列表底部的「添加」,起个备注名(如 XylemNode),供应商类型选 OpenAI,确定。

  3. 03

    填密钥与 API 地址

    填入密钥和 API 地址。这里和别的工具不一样:API 地址只填到域名,Cherry Studio 会自动补 /v1/chat/completions——所以别手动加 /v1,否则会拼重复。

    API 密钥
    sk-你的密钥
    API 地址
    https://api.xylemnode.com
  4. 04

    添加模型并启用

    点左下角「管理」自动拉取模型、按 + 加入(或手动输入模型名,如 gpt-5.6-sol)。用密钥框旁的「检测」测通,最后打开右上角开关启用这个供应商。

API 地址填写说明

① Cherry Studio 默认会在你填的地址后自动拼 /v1/chat/completions,所以标准情况只填根地址 https://api.xylemnode.com 即可,别自己加 /v1。 ② 如果想固定成完整地址、不让它自动拼接,可填 https://api.xylemnode.com/v1/chat/completions 并以 # 结尾,此时只用你输入的地址。

常见问题

Cherry Studio 报 404 或路径重复?

它和别的工具相反:API 地址只填到域名,剩下的 /v1/chat/completions 由它自己拼接——官方文档明确写了会自动拼接,不按要求填就可能用不了。所以手动加 /v1 反而会拼成重复路径。它文档里提到可以用 # 结尾来固定完整地址,但这条在部分版本上并不生效(仓库里有以 # 结尾仍被追加路径的 issue),所以遇到路径重复的报错,回到「只填域名」这条最稳。