Cherry Studio 接入自定义 API 配置教程

这篇教程说明如何在 Cherry Studio 里添加 HRouter 作为服务商，使用 OpenAI、Claude、Grok 和 Google 模型。核心是按模型协议选对服务商类型和 Base URL：OpenAI 系带 /v1，Claude 和 Gemini 用站点根地址。模型权限以当前 Key 的实时返回结果为准。

开始前

• 一个可用的 HRouter Key。
• 当前 Key 的模型列表：用 GET https://hrouter.net/v1/models 查询（见 查询可用模型），或者先在 HRouter Desktop 里点“识别 Key”查看。

添加 OpenAI / Codex / Grok 模型

在设置里新增一个 OpenAI 兼容服务商：

模型填写当前 Key 返回的 OpenAI 模型；Grok 使用 grok-4.5。

添加 Claude 模型

Claude 建议单独新增一个 Anthropic 类型的服务商：

模型从当前 Key 返回的 Claude 模型中选择。

添加 Google Gemini 模型

如果你的 Cherry Studio 版本支持 Gemini 自定义服务商，Base URL 使用：

https://hrouter.net

模型请选择当前 Key 返回的 Gemini 型号，不要照抄过期版本名。

为什么要分成多个服务商

不同协议的 Base URL 规则不同：OpenAI 系需要 /v1，Anthropic 和 Gemini 不能带。分成多个服务商，每个只填一种地址，不容易出错，详见 API 地址对照表。

验证

在对话里选好模型，发一句“请只回复：连接成功”，再到 使用记录 确认请求出现。

常见问题

模型列表为空？ 检查 Key 权限，或手动添加 /v1/models 返回的模型，见 查询可用模型。

返回 401？ 重新复制 Key，确认没有空格，见 API 401 报错。

返回 404？ 检查协议是否和 Base URL 匹配，见 404 路径错误。

提示 model_not_found？ 模型名不在当前 Key 的实时模型列表中，见 model_not_found。