Cherry Studio 接入中转站：添加自定义服务商，地址填到哪一级

Cherry Studio 是开源的 AI 桌面客户端，支持 Windows、macOS 和 Linux。它内置了很多家模型服务，也可以添加自定义的服务商，接中转站用的就是后者：

设置 → 模型服务，点列表下方的 + 添加服务商；
填名称、中转站的 key 和地址；
点 获取模型列表，把要用的模型加进来；
点检测验证，再打开右上角的启用开关。

最后一步最容易漏。官方文档用醒目的提示写着：配置好后务必打开启用开关，否则这个服务商的模型不会出现在模型选择列表里。

如果你还没弄清中转站是什么、有哪些风险，先读中转站是什么和用中转站有什么风险；选站可以看中转站排行榜。

开始之前：从中转站拿到三样东西

需要什么	说明
接口地址	OpenAI 兼容接口的地址；用 Claude 的话，再看它有没有单独的 Anthropic 接口地址
模型名	中转站模型页上写的名字
API key	在中转站的控制台创建。Cherry Studio 里叫“API 密钥”，有的中转站叫“令牌”，是同一个东西

1添加自定义服务商

点左侧导航栏的设置（齿轮图标），进入 模型服务。列表里是已有的服务商，点下方的 + 添加服务商，打开“添加自定义提供商”的弹窗。

按官方文档，弹窗里填三项：

项目	填什么
提供商名称	自己起一个认得出的名字
API 密钥	中转站的 key
端点设置	中转站的接口地址。默认可以填 OpenAI 和 Anthropic 两种端点；点“更多设置”还能加 OpenAI Responses、Gemini 等端点

填完点添加。

版本不同，弹窗长得不一样。 官方文档的另一些页面里，这个弹窗是“填名称，再选提供商类型”：用 OpenAI 兼容接口选 OpenAI，用 Claude 原生接口选 Anthropic，地址和 key 到下一步的配置页再填。两种界面填的是同样的内容，以你安装的版本为准。

2地址填到哪一级

这是最容易填错的地方。官方文档在“模型服务设置”里写了规则：

通常只填根地址。 服务商给的如果是 https://xxx.com/v1/chat/completions 这种完整地址，只填 https://xxx.com，Cherry Studio 会自动补上 /v1/chat/completions。
路径不常规时，末尾加 #。 请求路径不是常规的 /v1/chat/completions 时，填完整的地址并以 # 结尾。以 # 结尾表示不再自动拼接版本路径，只用你填的地址。

所以中转站文档里的地址要先看清楚是哪一种：

中转站给的地址	在 Cherry Studio 里填
`https://你的中转站地址/v1/chat/completions`	`https://你的中转站地址`
明确说路径里没有 `/v1`	完整地址，末尾加 `#`

以酷站AI 为例：它的文档写的 OpenAI 兼容接口是 https://api.koozhan.com/v1/chat/completions，按上面的规则，在 Cherry Studio 里填 https://api.koozhan.com。

也有中转站在自己的接入文档里直接给出 Cherry Studio 里要填的写法。有这种说明时照它写，填完用下面的“检测”确认。

另外两点来自官方文档：地址要带对 http:// 或 https://，没有开启 SSL 的服务不要写成 https；地址是 IP 加端口时，写成 http://IP:端口。

3添加模型

在服务商的配置页点 获取模型列表，Cherry Studio 会向中转站拉取它支持的模型。在弹出的列表里点模型右侧的 +，把它加进你的模型列表。官方文档强调，只有加进列表的模型才会出现在各处的模型选择器里。

拉不到列表时，点 + 手动填模型 ID。

官方文档还提醒了一个细节：模型名称下面会显示服务商返回的实际 API 模型 ID，名字相近的日期版、带厂商前缀的版本不会被合并。添加之前核对这一行，免得选到同名的另一个版本。中转站的模型列表往往很长，官方的建议是只加实际会用到的。

4检测，然后打开开关

点检测，选一个模型测试。通过就说明地址、key 和模型名都对。官方文档对失败的提示是：检查模型列表里有没有填错的或不受支持的模型。

最后打开配置页右上角的启用开关。列表里已启用的服务商右侧会有一个绿色的圆点。

回到对话界面，在模型选择器里选这个服务商下面的模型，就可以用了。

中转站是 New API 搭的：用内置的服务商更省事

Cherry Studio 内置了一个叫 New API 的服务商。官方文档说明，一个 New API 地址可以同时连接 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 四种协议，不需要为每种协议分别添加服务商。

你的中转站如果写明是用 New API 搭建的，可以直接用它：

设置 → 模型服务 → New API；
填 API 密钥；
API 地址填根地址，例如 https://你的中转站地址；
获取或手动添加模型，检测通过后打开启用开关。

官方的两条提醒：

Cherry Studio 会按所选协议自动使用对应的版本路径，通常只需填一次根地址，不要把 /chat/completions 这样的完整接口路径贴进去。
只有当中转站明确要求使用不带 /v1 或 /v1beta 的路径时，才在对应的地址末尾加 #。普通的 New API 部署不要加。

一个服务商填多把 key

官方文档说明，一个服务商可以配置多个密钥，按顺序轮流使用。多个 key 之间用英文逗号隔开，比如 sk-xxx1,sk-xxx2，官方强调必须是英文逗号；也可以点输入框右侧的钥匙图标逐个管理。

常见问题

现象	检查什么
模型选择器里没有这个服务商	右上角的启用开关有没有打开
获取模型列表是空的	地址填的层级对不对，末尾有没有多余的斜杠；key 是否复制完整
检测失败	地址是否按上面的规则填；选来检测的模型是不是这把 key 能用的
返回 `404`	多半是路径重复或缺了一段。对照“地址填到哪一级”一节
能连上，但用的模型不对	核对模型名称下面那一行实际的模型 ID
多个 key 只有第一个生效	分隔用的是不是英文逗号
Claude 模型的工具调用、思考不正常	中转站有 Anthropic 原生接口的话，改用 Anthropic 端点

最后一条不是官方文档的原话，是接各种工具时通用的经验：Claude 走原生接口，比经过一层 OpenAI 格式的转换少一个出问题的环节。

接上之后

“检测”通过不等于模型是真的。 它只说明接口能通。中转站给的是不是它声称的模型，要用同一把 key 到 Veridrop 检测，背景见中转站怎么掺假。
别靠问模型“你是谁”来判断。 原因见问“你是什么模型”为什么验证不了真假。
知识库和文件也会经过中转站。 对话里引用的文档内容会发给模型，涉及公司资料时先想清楚，见用中转站有什么风险。
其他客户端的接法：Chatbox 接入中转站、LobeHub 接入中转站。