Cherry Studio 接入 apimodels.app 的配置方法
Cherry Studio 是一个开源的桌面客户端,用来和各种大模型对话。它支持自己添加服务商,填一个 API 地址和一把 key 就行。接 apimodels.app 用的就是这个功能:一把 key,这把 key 能用的模型都出现在同一个服务商下面。
下面的界面文字是 2026 年 11 月 17 日从 Cherry Studio 的源码和语言文件里核对的(2.2.2 版)。更早的 1.x 版本对话框不一样。
添加服务商
进入「设置 → 模型服务」,点列表底部的「添加服务商」,会弹出「添加自定义提供商」对话框。
| 字段 | 填什么 |
|---|---|
| 提供商名称 | 随意,例如 apimodels |
| API 密钥 | 你的 apimodels.app key |
| 端点设置:OpenAI | https://api.apimodels.app/v1 |
| 端点设置:Anthropic(可选) | https://api.apimodels.app |
地址是怎么拼出来的
每个地址输入框下面都有一行「请求路径」预览,保存前就能看到最终地址。OpenAI 那一栏应该显示 https://api.apimodels.app/v1/chat/completions,Anthropic 那一栏应该显示 https://api.apimodels.app/v1/messages。
Cherry Studio 只在地址里没有版本号时才自动补 /v1,所以 OpenAI 那一栏填 https://api.apimodels.app 或 https://api.apimodels.app/v1 结果一样。地址末尾加 # 会关闭自动补版本,这里用不到。
至少要配一个文本端点。只配 OpenAI 这一个,就能用这把 key 上的全部语言模型,包括 Claude。想让 Claude 走 Anthropic 消息格式时,再填 Anthropic 那一栏。
打开开关,添加模型
点「添加」之后,进入这个新服务商,把右上角的开关打开。然后点「模型」标题旁边的「同步模型」,Cherry Studio 会从我们的模型列表接口把列表拉回来。
列表里是这把 key 能用的全部模型,包括图像、视频、音频模型,这些放进对话窗口是用不了的,只添加你要用的语言模型。拉回来的模型要加进这个服务商的模型列表之后,才会出现在对话的模型选择里。
想手动加,点旁边的加号,填模型 ID,例如 claude-opus-5-5。
检测连通性
点 API 密钥输入框右边的「检测」。它会用你的 key 向列表里的一个模型发一次真实请求,所以会消耗一点点余额。检测通过说明地址、key 和模型都没问题。
限制和常见问题
模型能回答,但看不了图或用不了工具。 打开这个模型的编辑面板,在「模型能力」里勾上对应的项(视觉、工具、推理)。自定义服务商的模型有什么能力,Cherry Studio 并不知道。勾选只是在界面上启用功能,模型本身要支持才行。
带思考的模型开口慢。 qwen4-max 是想完才开始输出,第一句话可能要等几十秒。
图像和视频模型不适合放在对话窗口里用。 这些请直接调 API,请求格式见各模型页。
多把 key。 Cherry Studio 支持用英文逗号分隔填多把 key,会轮流使用。
出处
界面文字和地址规则取自 Cherry Studio 仓库(main 分支,2.2.2 版),2026 年 11 月 17 日核对,包括自定义服务商对话框的代码、地址格式化函数、模型列表拉取逻辑和语言文件。我们没有逐个版本测试 Cherry Studio。
调用示例
cURL
# Check the address and key outside Cherry Studio
curl https://api.apimodels.app/v1/chat/completions \
-H "Authorization: Bearer $APIMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"messages": [{"role": "user", "content": "Say hello in one word."}]
}'常见问题
Cherry Studio 里 API 地址填什么?
OpenAI 那一栏填 https://api.apimodels.app/v1。输入框下面的预览应该显示 https://api.apimodels.app/v1/chat/completions。
为什么对话里选不到模型?
检查两点:服务商右上角的开关有没有打开;同步模型之后,有没有把模型加进这个服务商的模型列表。
能通过 apimodels.app 在 Cherry Studio 里用 Claude 吗?
能。把 claude-opus-5-5 或 claude-sonnet-5-5 加进模型列表即可。走 OpenAI 那个地址就能用,Anthropic 那个地址可填可不填。
「检测」会扣费吗?
会,但很少。它会向你选的模型发一次真实请求。
