03 接入第一个模型
前一章拆开了 API 请求。现在我们把地址、凭据和模型这些概念落到 Cherry Studio 的配置中。
目标很具体:连接一种可用服务,用一段已知材料获得真实回答,再判断接入链路与任务结果各完成到哪里。第一次接入不需要同时配置十几个模型。
3.1 先准备可用的调用条件
你需要一个可调用的模型服务,以及该服务要求的账号授权或凭据。服务的获取方式、额度和可用模型以当期官方说明为准,本课程不要求购买某一种套餐。
课堂应提前准备经过预演的服务说明。如果你已有常用配置,可以复用;如果暂时没有权限,不要把第 02 章的示例密钥当成可用账号。
记录四项信息:服务名称、协议类型、客户端需要填写的地址、课程使用的模型标识。真实凭据单独存入配置,不写进记录表。
3.2 把配置与概念对应起来
实际界面中“设置—模型服务”列出服务、模型与凭据管理。截图保留产品原生的密钥遮挡,没有显示完整凭据。这里展示入口,不代表每个列出的模型都已测试成功。
打开“设置—模型服务”,选择合适的服务模板或按需要新增服务。当前界面名称若有变化,先查对应版本的说明。
| 配置项 | 你需要核对什么 |
|---|---|
| 服务类型或协议 | 客户端会采用哪种请求格式 |
| API 地址 | 这里要求基础地址还是固定完整路径 |
| API 密钥或授权 | 是否属于这个服务,是否仍有效 |
| 模型列表 | 实际选择的模型标识及相应能力 |
同一家服务可能提供多种协议入口。不要根据“都是同一个品牌”就把不同入口的字段混用。模型服务配置说明
3.3 获取列表 检测连接与发送任务
获取模型列表、连接检测、发送实际任务是三种动作。它们可能使用不同请求,也可能只检查链路中的部分条件。
看到了模型名称,说明客户端能够展示相应信息。连接检查通过,说明它执行的那项检查通过。真正的问题和材料还要发送出去,才能观察具体模型的返回。
因此第一次任务选一个短、答案明确的问题。这里暂时不启用附件、知识库或外部工具,先把额外变量收起来。
3.4 用已知事实判断结果
下面是 2026 年 10 月 14 日在安装版 Cherry Studio 2.1.6 中的实际返回。课程专用助手使用界面显示的 DeepSeek V4.1 Flash|深度求索,没有绑定知识库或开启联网。输入仅提供四项活动事实及三项未知信息。
本次四项事实与输入一致,三项未知信息没有被补写。界面用量和速度文字只是产品显示,不作为独立的性能或计费测量。
活动资料的当前事实是:11 月 21 日、10:00—12:00、301 室、容量 30 人。把它明确提供给模型,要求提取四项信息,能够检查任务返回和事实保留。
如果服务正常返回但提取错了一个数字,接入可能已经完成,而内容质量仍需要处理。不要把这两件事合并成一个“连接失败”。
实验 E05 完成第一次真实调用
准备
一种可用文本模型服务和课程说明;新建一个课程话题。记录所用版本、服务与模型,不记录密钥。
操作步骤
- 按服务说明填写客户端要求的协议、地址和授权信息。
- 获取或手动添加课程模型,选择一个兼容的文本模型。
- 如果界面提供连接检测,可以先执行,但单独记录结果。
- 新建话题,发送下面的固定任务。
- 保存实际返回;若失败,保存脱敏错误文本,不重复提交无效请求。
- 对照原材料检查四项字段,并将“调用返回”与“提取正确”分别记录。
请只根据材料提取事实,不增加外部信息。
材料:青禾社区 AI 体验日于 2026 年 11 月 21 日
10:00—12:00 在 301 室举行,场地容量为 30 人。
用四行输出:日期、时间、地点、容量。完成标准
你能够解释每项配置的用途,保存一次真实任务的返回,并逐项核对。如果暂时没有可用服务,可以完成配置阅读,但要把真实调用标为未完成。
参考解释与异常处理
四项事实应对应输入材料。若错误涉及鉴权或地址,先检查配置;若已经获得回答但事实有误,先检查输入和回答。没有收到响应不能直接认定模型不会处理这个任务。
3.5 在同一个工作台里增加第二种选择
接入完成后,可以先尝试同一服务内的另一模型,再考虑另一服务。每次只改变一种条件,才容易理解差异来自哪里。
如果模型能力不同,例如一个只接受文字、另一个支持视觉,先按任务需要比较能力,不用把所有模型都塞进同一排名。
实验 E06 更换模型与更换服务
操作步骤
- 保留 E05 的输入和返回,新开话题,只切换同一服务中的另一个兼容模型。
- 用相同材料和问题获得实际结果;记录参数支持差异。
- 填写“地址是否改变、凭据是否改变、模型标识是否改变”的对照表。
- 若准备了第二个服务,重新核对它的协议、地址和鉴权,再执行同一小任务。
- 将无法控制的差异列出来,不因为两次结果不同就直接认定某一个模型更强。
完成标准
能把切换模型和切换服务分开解释。只有一个可用服务时,第二服务部分可以采用脱敏配置阅读,不冒称已经完成实测。
参考解释
同一服务中的模型切换通常不需要修改服务凭据,但实际权限仍依服务而定。服务迁移会改变更多条件,应该先让最小任务工作起来,再逐步增加附件或工具等能力。
自检题
01看到了模型列表,是否说明每个模型都能调用?
不说明。列表是可发现或已登记的信息,具体模型仍可能受账号权限、能力配置或服务状态影响。要用相应任务获得一次实际返回。
02为什么第一次调用只使用短材料?
短任务能减少文件解析、长上下文和复杂推理等额外变量,帮助先确认接入链路。它不证明复杂任务也能成功,后续再逐步增加能力。
03只切换模型和更换服务有哪些不同?
同一服务内切换模型通常保留服务地址与凭据,但要核对模型能力。更换服务还要核对协议、地址、鉴权和权限,不能只替换模型名字。
04真实密钥应该出现在实验记录里吗?
不应出现。记录服务名称、模型标识、协议类型和结果即可。凭据留在客户端配置中,公开材料使用占位符。
接下来选择与诊断
接入以后,下一步是知道选什么、出错后检查什么。第 04 章会用固定任务比较模型,并把问题分回相应层级。
本章资料:Cherry Studio 模型服务、DeepSeek 首次调用示例。具体字段和可用模型按你使用的服务与版本确认。

