为什么 Cherry Studio 很适合接入 APIporter
Cherry Studio 本身就是一款非常适合多模型使用场景的 AI 客户端。它支持统一管理多个服务商，也支持通过自定义服务商的方式接入第三方接口。对于想同时使用 Claude、GPT、Gemini、DeepSeek 等模型的人来说，Cherry Studio 配合 APIporter 其实是一个很顺手的组合。
原因很简单：APIporter 底层就是 NewAPI，在大部分客户端里都可以按 OpenAI 兼容接口 的方式接入。而 Cherry Studio 官方文档里，对 NewAPI 的接入方式也正是这条路线。所以如果你想在 Cherry Studio 里统一使用 APIporter 提供的多个主流模型，最稳的办法不是四处乱试，而是直接按照 Cherry 官方文档里的 NewAPI / OpenAI-compatible 路线来配置。
接入前需要准备什么
在开始之前，你需要先准备好三样东西：
第一，是已经安装好的 Cherry Studio 客户端；第二，是你自己的 APIporter API Key；第三，是 APIporter 的接口根地址，也就是 www.apiporter.com 对应的可用 API 根路径。除此之外，你最好还确认一下自己准备调用的模型名称，例如 Claude、GPT、Gemini 或 DeepSeek 在 APIporter 里的具体模型 ID，这样后面添加模型时会更顺。
这里要特别提醒一点：在 Cherry Studio 里接 APIporter，不是去找某个叫“APIporter”的内置服务商，而是要通过 添加服务商 + 选择 OpenAI 提供商 的方式来完成配置。
第一步：进入 Cherry Studio 的模型服务设置
打开 Cherry Studio 后，先点击左下角的设置入口，然后进入 模型服务 页面。这个页面就是 Cherry Studio 管理各类模型提供商的地方。官方文档里的 OpenAI、NewAPI、OneAPI、Gemini 等接入教程，都是从这里开始。
.png?alt=media)
进入模型服务页面后，不要直接去改已有的 OpenAI 服务商，而是建议你点击服务商列表底部的 添加，单独给 APIporter 新建一个服务商入口。这样后面管理更清晰，也方便和其他服务商区分。
第二步：新增服务商时，提供商选择 OpenAI
在新增服务商的弹窗里，你可以把备注名称写成 APIporter，这样后面一眼就知道这个配置是给 APIporter 用的。最关键的是，提供商这里要选择 OpenAI。
这一点并不是拍脑袋乱配，而是来自 Cherry Studio 官方文档里 NewAPI 的真实接入方式。官方文档明确写到：添加 NewAPI 时，要在 Cherry Studio 里点击添加，自定义备注名称，然后 提供商选 OpenAI，接着再填写密钥和根地址。所以 APIporter 既然底层就是 NewAPI，这里走 OpenAI 兼容路线就是正确做法。
第三步：填写 APIporter 的 API Key 和根地址
新增好服务商之后，就进入具体配置页。首先在 API Key 位置填入你从 APIporter 获取到的密钥。然后再填写接口地址。
根据 Cherry Studio 官方文档里的 NewAPI 教程，这里一定要注意：只填写根地址，不要把完整接口路径整段粘进去。也就是说，你填写的应该是 API 根地址，而不是诸如 /v1/chat/completions 这种具体接口路径。
.png?alt=media)
如果你的 APIporter 接口使用的是标准 OpenAI 兼容写法，通常实际填写时会是类似下面这样的形式：
https://www.apiporter.com/v1
当然，最终还是要以你 APIporter 实际提供的根地址为准。核心原则就一个：填 Base URL，不要填完整接口路径。
第四步：添加模型
API Key 和根地址填完之后，下一步就是添加模型。Cherry Studio 官方文档对 OpenAI 和 NewAPI 都写得很明确：配置完成后，点击底部的 管理 或 添加，把你要使用的模型加进去，然后打开右上角服务商开关即可使用。
%20(2).png?alt=media)
如果 Cherry Studio 能自动获取 APIporter 提供的模型列表，那你可以直接在管理页里拉取；如果自动获取不到，也可以手动输入模型名称。建议你先加几个最常用的模型做测试，比如：
claude-4.7
gpt-5.4
gemini-3.1
deepseek-chat
这里要注意，模型名称一定要和 APIporter 后端实际支持的模型 ID 保持一致。不要只写显示名，否则很容易出现模型选得到但调用失败的情况。
第五步：打开服务商开关并开始使用
模型添加完成之后，把右上角的服务商开关打开。如果配置项没有问题，这个服务商就已经可以在 Cherry Studio 的对话界面里正常使用了。
这时候你回到对话页面，选择刚刚配置好的 APIporter 服务商，再选择它下面的 Claude、GPT、Gemini 或 DeepSeek 模型，就可以直接开始对话。
如果当前版本的 Cherry Studio 提供了连接检查按钮，也建议你先点一下，确认 API Key、接口地址和模型都正常，再正式开始使用。
常见问题：为什么这里选的是 OpenAI，而不是 APIporter 或 NewAPI
这是很多人第一次配置时最容易疑惑的地方。原因其实不复杂：Cherry Studio 在客户端层面主要区分的是 协议兼容方式，而不是你服务商的品牌名字。APIporter 底层既然是 NewAPI，那么对客户端来说，它就是一个 OpenAI-compatible 服务端。所以在 Cherry Studio 里，按官方文档的 NewAPI 路线来配置，也就是 提供商选 OpenAI，才是最标准的接法。
常见问题：地址应该怎么填才不容易出错
最容易犯的错，就是把完整请求地址整段粘进去。比如把 /v1/chat/completions 也一起填进去，这样很多时候会直接导致客户端连接异常。Cherry Studio 官方文档已经明确说明：这里只需要复制根地址。
如果你的 APIporter 后台给你的接入说明里写的是 OpenAI 兼容地址，那么通常应该填写的是 API 根路径。最稳的判断方法就是：如果这个地址在代码里通常用作 base_url，那它大概率就是这里该填的值。
常见问题：如果自动获取不到模型怎么办
这种情况并不稀奇，也不一定是你配置错了。很多时候只是客户端没有正确解析模型列表接口，或者当前服务端没有开放自动获取。这时候最简单的办法就是：手动添加模型名称。
只要模型名填对，API Key 正常，地址正常，服务商照样能用。
为什么用 APIporter 接 Cherry Studio 更省心
如果你平时就喜欢在 Cherry Studio 里切换不同模型测试效果，那么 APIporter 这种聚合方式会明显更顺手。你不用分别管理多个官方接口，也不用来回折腾不同平台的计费和限制。对日常多模型切换、对比和长期使用来说，这种统一接入方式比单独接多个官方接口更省心。
尤其是你想同时使用 Claude、GPT、Gemini、DeepSeek 这些主流模型时，Cherry Studio + APIporter 这套组合会更接近真正可长期使用的工作流，而不是一堆临时拼起来的配置。
总结
Cherry Studio 接入 APIporter，最核心的就一句话：把 APIporter 当成 OpenAI 兼容服务商来接。对应的配置主线就是：
设置 → 模型服务 → 添加服务商 → 提供商选 OpenAI → 填 APIporter API Key → 填 APIporter 根地址 → 添加模型 → 打开开关 → 开始使用。
如果你已经准备好了 APIporter 的密钥和地址，这套流程走下来其实并不复杂。真正关键的是别选错服务商类型，也别把接口地址填错成完整请求路径。
