接入指南
Cherry Studio
跨平台开源桌面 AI 客户端(Windows / macOS / Linux),一个界面聚合多家模型。加一个 OpenAI 类型的自定义供应商,就能把 XylemNode 接进来。
- 01
安装
到 Cherry Studio 官方仓库 / 官网下载对应系统的安装包,装好并打开。
- 02
新建 OpenAI 类型供应商
进入 设置 → 模型服务,点列表底部的「添加」,起个备注名(如 XylemNode),供应商类型选 OpenAI,确定。
- 03
填密钥与 API 地址
填入密钥和 API 地址。这里和别的工具不一样:API 地址只填到域名,Cherry Studio 会自动补 /v1/chat/completions——所以别手动加 /v1,否则会拼重复。
- API 密钥
sk-你的密钥- API 地址
https://api.xylemnode.com
- 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),所以遇到路径重复的报错,回到「只填域名」这条最稳。