Cherry Studio 添加 API 服务商：零基础配置指南

安装与安全准备

从 Cherry Studio 的官方发布渠道下载安装，核对域名或项目主页。第三方打包版本可能被修改，不适合填写带有账户余额的 API Key。

登录 API 服务商后台，为这个客户端创建独立密钥，并准备 Base URL 和准确的模型 ID。先保证账户有少量可用余额。

添加模型服务

进入设置中的模型服务页面。若服务商在列表中已有专用选项，优先按其文档选择；如果文档写明兼容 OpenAI 接口，则使用自定义 OpenAI 类型。

依次填写 API 密钥和 API 地址。点击检查或测试按钮后，再获取模型列表。自动获取失败时，可按文档手动新增模型 ID，这并不一定表示线路不可用。

选择并启用模型

模型被添加后还要确认它处于启用状态，并在聊天助手中选为当前模型。很多“已经填好却不能用”的情况，是因为对话仍选中了另一个未配置的模型。

先关闭联网搜索、知识库、图片识别和工具调用，只测试纯文字。连接成功后逐项开启附加功能，这样出错时容易定位。

验证账单与上下文

发送一个短问题，再发送一段约三百字的摘要任务。到服务商后台确认两条调用记录、模型名称和扣费是否一致。随后新建对话测试，避免旧对话中的错误配置继续影响结果。

迁移和备份注意事项

导出客户端数据前检查备份是否包含密钥。如果要把配置交给别人，只分享 Base URL 和模型名称，密钥应由每个人单独创建。旧电脑不再使用时，在服务商后台撤销旧密钥。

当界面更新导致按钮位置变化时，按照“服务类型、地址、密钥、模型、启用、测试”的顺序寻找，仍能完成配置。