APIMODELSAPIMODELS

Cherry Studio 接入 apimodels.app 的配置方法

TL;DR 在 Cherry Studio 里打开「设置 → 模型服务 → 添加服务商」,起个名字,粘贴你的 apimodels.app key,OpenAI 的地址填 https://api.apimodels.app/v1。把服务商的开关打开,点「同步模型」,把要用的语言模型加进来,例如 claude-opus-5-5、qwen4-max、gpt-6-sol。最后用「检测」确认 key 可用。

Cherry Studio 是一个开源的桌面客户端,用来和各种大模型对话。它支持自己添加服务商,填一个 API 地址和一把 key 就行。接 apimodels.app 用的就是这个功能:一把 key,这把 key 能用的模型都出现在同一个服务商下面。

下面的界面文字是 2026 年 11 月 17 日从 Cherry Studio 的源码和语言文件里核对的(2.2.2 版)。更早的 1.x 版本对话框不一样。

添加服务商

进入「设置 → 模型服务」,点列表底部的「添加服务商」,会弹出「添加自定义提供商」对话框。

字段填什么
提供商名称随意,例如 apimodels
API 密钥你的 apimodels.app key
端点设置:OpenAIhttps://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 那个地址可填可不填。

「检测」会扣费吗?

会,但很少。它会向你选的模型发一次真实请求。

相关阅读

收录于
APIMODELS on Product HuntAPIMODELS featured on ToolifyAPIMODELS featured on There's An AI For That