上周有个朋友在群里问我「Cherry Studio 怎么配第三方 API 地址官方文档写得太简略了我填了 Base URL 但一直报错。」我当时随口说了几句结果群里好几个人接着问才发现踩这个坑的人还真不少。正好我自己从去年开始就一直在用 Cherry Studio 当主力聊天客户端各种 Base URL 配过不下十来个今天把完整的配置流程和踩坑经验一次性写清楚。Cherry Studio 设置 Base URL 的核心步骤打开设置 → 模型服务商 → 选择或新增 Provider → 填写 API Key 和 Base URL → 保存后在对话中选择对应模型即可。整个过程不到 2 分钟但有几个细节搞错了就会一直 400/401 报错下面详细展开。先说结论配置项正确示例常见错误Base URL 格式https://api.xxx.com/v1末尾多加了/chat/completionsAPI Keysk-xxxxxxx复制时多了空格或换行符模型名称gpt-5、claude-sonnet-4-20250514随便填、拼写错误Provider 类型OpenAI Compatible选错了导致请求格式不对记住一个原则Cherry Studio 底层走的是 OpenAI 兼容协议Base URL 只填到/v1就够了后面的路径它会自己拼。环境准备Cherry Studio 版本v1.x 最新版2026 年目前更新很勤建议用最新的操作系统Windows / macOS / Linux 都行一个可用的 API Key官方的或者第三方聚合平台的都行方案一配置 OpenAI 官方 API最基础的场景直接填官方地址。步骤打开 Cherry Studio点击左下角设置图标齿轮左侧菜单找到「模型服务商」找到OpenAI默认就有点进去填写两个字段API Key: sk-proj-xxxxxxxxxxxxxxxxxxxx Base URL: https://api.openai.com/v1点右上角「检查」按钮验证连通性勾选你需要的模型GPT-5、GPT-4o 等保存回到对话页面顶部选模型就能用了注意Base URL 填https://api.openai.com/v1不要写成https://api.openai.com/v1/chat/completionsCherry Studio 会自动补全后面的路径。方案二配置第三方聚合 API省事说实话我现在基本不直接连各家官方了。我日常要在 GPT-5、Claude Opus 4.6、Gemini 3、DeepSeek V3 之间来回切每个单独配一个 Provider 管理起来烦死了各家鉴权方式还不一样。我目前用聚合 API 平台一个 Key 打天下。这里以 ofox.ai 为例它兼容 OpenAI 协议配置方式和方案一几乎一模一样步骤设置 → 模型服务商 → 点击「添加服务商」选择「OpenAI Compatible」类型名字随便写我填的「ofox聚合」填写API Key: 你在 ofox.ai 控制台拿到的 Key Base URL: https://api.ofox.ai/v1点击「检查」验证连通手动添加模型名称下面会讲怎么加添加模型的方法点「管理」或「添加模型」按钮手动输入模型 IDgpt-5 claude-sonnet-4-20250514 gemini-3-pro deepseek-v3 qwen-3-turbo glm-5每输一个回车确认最后保存。回到对话页顶部下拉就能看到这些模型了。ofox.ai 是一个 AI 模型聚合平台一个 API Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3 等 50 模型低延迟直连无需代理支持支付宝付款。配完之后在 Cherry Studio 里切模型就跟切频道一样不用反复改 Base URL。方案三配置 Anthropic Claude原生协议Cherry Studio 也内置了 Anthropic 的 Provider有 Claude 官方 Key 的也可以直连设置 → 模型服务商 → 找到Anthropic填写API Key: sk-ant-xxxxxxxxxxxxxxxxxxxx Base URL: https://api.anthropic.com注意这里和 OpenAI 不一样Anthropic 的 Base URL 不需要加/v1。Cherry Studio 针对 Anthropic Provider 做了适配会自动用 Anthropic 协议格式发请求。特别容易踩的坑——在 Anthropic Provider 下填https://api.anthropic.com/v1反而会 404。整体调用流程用户选择模型OpenAI/CompatibleAnthropicCherry Studio 客户端Provider 路由Base URL /chat/completionsBase URL /messagesAPI 服务端返回流式响应Cherry Studio 内部会根据 Provider 类型自动拼接不同的请求路径和格式。这就是为什么选对 Provider 类型特别重要。踩坑记录坑 1Base URL 末尾的斜杠问题❌ https://api.ofox.ai/v1/ 多了一个 / ✅ https://api.ofox.ai/v1 没有末尾斜杠有些版本的 Cherry Studio 会把末尾斜杠拼成https://api.xxx.com/v1//chat/completions双斜杠直接 404。永远不要在 Base URL 末尾加/。坑 2API Key 复制带了隐藏字符有次从网页控制台复制 Key粘贴到 Cherry Studio 死活验证不过。后来把 Key 先粘到记事本里看了一眼末尾有个\n换行符。建议先粘到纯文本编辑器里检查一下再填。坑 3模型名称必须精确匹配Cherry Studio 在「OpenAI Compatible」模式下不会自动拉取模型列表部分版本开始支持了但不一定好使需要手动填模型 ID。这个 ID 必须和 API 服务端支持的完全一致✅ gpt-5 ❌ GPT-5 大小写错了 ❌ gpt5 少了横杠 ✅ claude-sonnet-4-20250514 ❌ claude-4-sonnet 顺序错了填错了不会报语法错误而是返回model not found。第一次遇到还以为是 Key 有问题排查了半天。坑 4开了代理导致 SSL 错误本机开着代理工具Cherry Studio 有时候会报 SSL 证书错误。可以在设置里找到「代理设置」选「不使用代理」或者把代理工具设为直连模式。用聚合平台的好处就是延迟本来就低ofox.ai 大概 300ms 左右不需要额外折腾网络。我的配置方案折腾了一圈之后我现在 Cherry Studio 里就保留了两个 Providerofox聚合OpenAI Compatible—— 日常用一个 Key 切所有模型Ollama 本地—— 跑一些本地小模型做测试管理最简单也不用操心各家 API 的鉴权差异和 Key 过期问题。小结Core 就三件事选对 Provider 类型OpenAI Compatible 能覆盖 90% 的场景Base URL 填到/v1不多不少模型名称必须精确匹配 API 服务端搞定这三点基本不会出问题。还是报错的话八成是 Key 复制带了隐藏字符先去纯文本编辑器里检查一遍。有问题评论区聊我看到都会回。
Cherry Studio Base URL 怎么设置？2026 完整配置教程 + 多模型切换方案
发布时间：2026/7/13 13:38:13
上周有个朋友在群里问我「Cherry Studio 怎么配第三方 API 地址官方文档写得太简略了我填了 Base URL 但一直报错。」我当时随口说了几句结果群里好几个人接着问才发现踩这个坑的人还真不少。正好我自己从去年开始就一直在用 Cherry Studio 当主力聊天客户端各种 Base URL 配过不下十来个今天把完整的配置流程和踩坑经验一次性写清楚。Cherry Studio 设置 Base URL 的核心步骤打开设置 → 模型服务商 → 选择或新增 Provider → 填写 API Key 和 Base URL → 保存后在对话中选择对应模型即可。整个过程不到 2 分钟但有几个细节搞错了就会一直 400/401 报错下面详细展开。先说结论配置项正确示例常见错误Base URL 格式https://api.xxx.com/v1末尾多加了/chat/completionsAPI Keysk-xxxxxxx复制时多了空格或换行符模型名称gpt-5、claude-sonnet-4-20250514随便填、拼写错误Provider 类型OpenAI Compatible选错了导致请求格式不对记住一个原则Cherry Studio 底层走的是 OpenAI 兼容协议Base URL 只填到/v1就够了后面的路径它会自己拼。环境准备Cherry Studio 版本v1.x 最新版2026 年目前更新很勤建议用最新的操作系统Windows / macOS / Linux 都行一个可用的 API Key官方的或者第三方聚合平台的都行方案一配置 OpenAI 官方 API最基础的场景直接填官方地址。步骤打开 Cherry Studio点击左下角设置图标齿轮左侧菜单找到「模型服务商」找到OpenAI默认就有点进去填写两个字段API Key: sk-proj-xxxxxxxxxxxxxxxxxxxx Base URL: https://api.openai.com/v1点右上角「检查」按钮验证连通性勾选你需要的模型GPT-5、GPT-4o 等保存回到对话页面顶部选模型就能用了注意Base URL 填https://api.openai.com/v1不要写成https://api.openai.com/v1/chat/completionsCherry Studio 会自动补全后面的路径。方案二配置第三方聚合 API省事说实话我现在基本不直接连各家官方了。我日常要在 GPT-5、Claude Opus 4.6、Gemini 3、DeepSeek V3 之间来回切每个单独配一个 Provider 管理起来烦死了各家鉴权方式还不一样。我目前用聚合 API 平台一个 Key 打天下。这里以 ofox.ai 为例它兼容 OpenAI 协议配置方式和方案一几乎一模一样步骤设置 → 模型服务商 → 点击「添加服务商」选择「OpenAI Compatible」类型名字随便写我填的「ofox聚合」填写API Key: 你在 ofox.ai 控制台拿到的 Key Base URL: https://api.ofox.ai/v1点击「检查」验证连通手动添加模型名称下面会讲怎么加添加模型的方法点「管理」或「添加模型」按钮手动输入模型 IDgpt-5 claude-sonnet-4-20250514 gemini-3-pro deepseek-v3 qwen-3-turbo glm-5每输一个回车确认最后保存。回到对话页顶部下拉就能看到这些模型了。ofox.ai 是一个 AI 模型聚合平台一个 API Key 可以调用 GPT-5、Claude Opus 4.6、Gemini 3 等 50 模型低延迟直连无需代理支持支付宝付款。配完之后在 Cherry Studio 里切模型就跟切频道一样不用反复改 Base URL。方案三配置 Anthropic Claude原生协议Cherry Studio 也内置了 Anthropic 的 Provider有 Claude 官方 Key 的也可以直连设置 → 模型服务商 → 找到Anthropic填写API Key: sk-ant-xxxxxxxxxxxxxxxxxxxx Base URL: https://api.anthropic.com注意这里和 OpenAI 不一样Anthropic 的 Base URL 不需要加/v1。Cherry Studio 针对 Anthropic Provider 做了适配会自动用 Anthropic 协议格式发请求。特别容易踩的坑——在 Anthropic Provider 下填https://api.anthropic.com/v1反而会 404。整体调用流程用户选择模型OpenAI/CompatibleAnthropicCherry Studio 客户端Provider 路由Base URL /chat/completionsBase URL /messagesAPI 服务端返回流式响应Cherry Studio 内部会根据 Provider 类型自动拼接不同的请求路径和格式。这就是为什么选对 Provider 类型特别重要。踩坑记录坑 1Base URL 末尾的斜杠问题❌ https://api.ofox.ai/v1/ 多了一个 / ✅ https://api.ofox.ai/v1 没有末尾斜杠有些版本的 Cherry Studio 会把末尾斜杠拼成https://api.xxx.com/v1//chat/completions双斜杠直接 404。永远不要在 Base URL 末尾加/。坑 2API Key 复制带了隐藏字符有次从网页控制台复制 Key粘贴到 Cherry Studio 死活验证不过。后来把 Key 先粘到记事本里看了一眼末尾有个\n换行符。建议先粘到纯文本编辑器里检查一下再填。坑 3模型名称必须精确匹配Cherry Studio 在「OpenAI Compatible」模式下不会自动拉取模型列表部分版本开始支持了但不一定好使需要手动填模型 ID。这个 ID 必须和 API 服务端支持的完全一致✅ gpt-5 ❌ GPT-5 大小写错了 ❌ gpt5 少了横杠 ✅ claude-sonnet-4-20250514 ❌ claude-4-sonnet 顺序错了填错了不会报语法错误而是返回model not found。第一次遇到还以为是 Key 有问题排查了半天。坑 4开了代理导致 SSL 错误本机开着代理工具Cherry Studio 有时候会报 SSL 证书错误。可以在设置里找到「代理设置」选「不使用代理」或者把代理工具设为直连模式。用聚合平台的好处就是延迟本来就低ofox.ai 大概 300ms 左右不需要额外折腾网络。我的配置方案折腾了一圈之后我现在 Cherry Studio 里就保留了两个 Providerofox聚合OpenAI Compatible—— 日常用一个 Key 切所有模型Ollama 本地—— 跑一些本地小模型做测试管理最简单也不用操心各家 API 的鉴权差异和 Key 过期问题。小结Core 就三件事选对 Provider 类型OpenAI Compatible 能覆盖 90% 的场景Base URL 填到/v1不多不少模型名称必须精确匹配 API 服务端搞定这三点基本不会出问题。还是报错的话八成是 Key 复制带了隐藏字符先去纯文本编辑器里检查一遍。有问题评论区聊我看到都会回。
)
