Cherry Studio 怎么接第三方 API？添加模型与聊天验收

Cherry Studio 接第三方 API，要完成服务商配置、模型添加、服务商启用和聊天选模四步。获取到模型列表或连接检测通过，只能说明对应步骤有结果；最后仍需用选中的模型发送一条短消息，核对回复和服务端记录。本文针对桌面版普通文本聊天，官方资料核对日期为 2026-10-25，未安装客户端或用真实 Key 测试云岚API兼容性。

先准备一个能核对身份的配置

记录 Cherry Studio 版本、系统、服务商名称、协议和精确模型 ID。还没有 Key，可先走注册与首次调用流程；已有 Key，则从签发站点核对它可用的分组与接口。不要用模型展示名代替调用 ID，也不要把第三方令牌填到仍指向厂商官方域名的配置里。

本页按 OpenAI 兼容的 Chat Completions 聊天任务核对。Cherry Studio 也区分 Anthropic、Gemini 等接口；同一服务商支持多种端点，不等于每个模型都能走每种协议。官方模型服务分类

自定义服务商在哪里添加？

按当前中文桌面文档，进入“设置 → 模型服务”，选择“+ 添加服务商”，填写可识别的名称，例如“云岚API－文本测试”。当前自定义配置支持分协议填写端点；先配置本次要用的 OpenAI 端点及匹配的 Key，其他协议留到有需求时单独核对。保存后回到这个服务商的配置页。官方自定义服务商说明

地址要看客户端字段的拼接规则。官方对常规 OpenAI 兼容“API 地址”的说明是：通常填写根地址，由客户端补 /v1/chat/completions。按这一规则，云岚API对应根地址为 https://v2.cloudmist.cloud，目标聊天请求为 https://v2.cloudmist.cloud/v1/chat/completions；这是配置核对示例，不是已通过的连接记录。官方 API 地址说明

如果当前版本展示独立端点或完整路径字段，先按字段说明确认最终地址。不要把 SDK 的 /v1 前缀机械复制到所有输入框，也不要为消除报错随意加 #：官方将它用于固定完整路径，填错会改变请求目标。不同协议的基址关系见base_url 说明。

获取到模型，为什么聊天里还没有？

“获取模型列表”之后，还要在模型管理里将目标模型加入自己的列表。同步失败时，可以在已确认服务商支持该 ID 和协议的前提下手动添加；手填成功只表示客户端保存了配置，不证明服务端有这个模型。官方自定义模型管理

接着打开服务商的启用开关。选择模型时同时核对它所属的服务商和实际 API ID，避免选中另一家服务商下名称相同的条目。不同功能页面还会按能力过滤模型，因此普通聊天、嵌入或绘画的列表不一定相同；修改本地类型也不会让上游凭空获得能力。官方模型服务设置、官方常见问题

怎样完成一次有用的聊天验收？

可以先在“检测”中选定本次要测的模型，记录结果；有多个 Key 时也记录实际选择的凭证标签，表里不保存 Key。随后返回“对话”，新建或打开一个助手，在输入框上方选择刚添加的模型。这个选择步骤来自官方快速开始。

先用一个没有附件、知识库或工具的小任务，例如“把‘下午三点开会’改写为一条礼貌提醒，只输出一句话”。以下是验收计划，尚未执行：

通过后，再按实际需求单独测图片、工具或较长上下文。流式文字出现不等于已经完整结束，相关判据见输出不完整排查。模型身份不能靠一句自报证明，费用也不能从本地模型价格设置推定，实际账单按用量对账方法核对。

卡住时，先定位在哪一步

遇到明确的 401、404 或限流响应，再进入调用报错排查。不要同时更换地址、模型和 Key，否则难以判断哪一项起作用。

下载检查表

下载 Cherry Studio 配置与聊天验收包，按同一配置逐项填写。包内只有静态清单、空白 CSV 和人工场景，未包含密钥、可执行程序或真实调用结果。提交问题前，保留版本、字段名称及脱敏错误，移除密钥和私密对话。

常见问题

检测通过，还需要发消息吗？

需要。检测可能用的模型或参数与当前助手不同。要确认目标聊天任务，需选择同一服务商下的目标模型实际发送，并记录完整结果。

没获取到模型列表，能不能手动添加？

可以按官方自定义服务商功能手动添加，但前提是知道准确 ID 和接口支持。这样只能绕过列表添加步骤，不能绕过鉴权或模型权限。

API 地址到底要不要带 /v1？

按当前字段规则。官方常规地址示例使用根地址并由客户端补路径；独立端点、完整 URL 和 SDK 基址不能混填。判断依据是最终目标请求，不是统一加或删 /v1。

能聊天就说明图片、知识库和智能体都可用吗？

不能。这些任务涉及不同模型能力、接口和应用配置。先保留已通过的聊天配置，再为所需功能分别设置验收条件。