Cherry Studio
将 Cherry Studio 多模型桌面客户端连接到 Bamboo Relay。
Bamboo 兼容接入
Cherry Studio 由其项目团队提供，本页是 Bamboo 维护的兼容配置指南。
Cherry Studio 是支持多模型对话、助手和知识库的桌面客户端。你可以使用应用内的自定义提供商连接 Bamboo。
准备配置
Cherry Studio 的不同版本可能显示两种地址字段，按你选择的提供商模式填写：
| 提供商模式 | 地址 |
|---|---|
| 会自动补全 OpenAI 路径的兼容提供商 | https://api.bamboonode.cn |
| 自定义 OpenAI Base URL | https://api.bamboonode.cn/v1 |
API Key 从令牌管理创建，模型 ID 从模型广场复制。
配置步骤
- 打开“设置 → 模型服务”，新增一个自定义 OpenAI 兼容提供商。
- 将名称设为
Bamboo Relay，按当前字段类型填写地址和 API Key。 - 使用“添加模型”手动录入 Bamboo 模型 ID；如果版本支持拉取模型列表，也可以先尝试自动获取。
- 启用模型并保存配置。
- 新建助手或对话，选择该模型发送测试消息。
地址判断
如果测试出现重复的 /v1/v1，改用不带 /v1 的地址；如果请求直接落到站点根路径或返回 404，改用带 /v1 的 Base URL。
知识库需要额外配置向量模型。请从模型广场选择可用的 Embeddings 模型，并在知识库设置中单独指定。