Cherry Studio 接入指南

适用角色：开发者、主用户、子用户 更新日期：2026-08-06

Cherry Studio 支持添加自定义模型服务。Provider 名称可以自定义，协议类型选择 OpenAI Compatible。

创建模型服务

进入设置中的模型服务，添加一个 Provider。截图来自 Cherry Studio 实际界面，无关 Provider 已脱敏，菜单位置可能随版本变化。

Provider 连接信息：

API 地址: https://<接口地址>
API Key: YOUR_API_KEY

以控制台「API Key」页展示的接口地址为准。

随后进入模型管理，添加控制台「调用指南」中的模型调用名。展示名称可以自定义，模型 ID 不要改写。

启用和验证

启用 Provider 后，在聊天页选择新增模型。模型列表为空时可以手动添加调用名；连接测试失败时先检查地址末尾是否重复 /v1 或斜杠。

聊天有回复但模型列表仍显示异常时，以控制台使用记录为准，并检查 Cherry Studio 是否同时保留了同名的旧 Provider。