Cherry Studio 接入教程

适合什么场景

Cherry Studio 适合日常对话、写作、翻译、总结、图片相关任务和多模型切换。它是桌面图形界面，新手通常比终端工具更容易上手。

如果你的目标是“像使用聊天软件一样使用 JiaPi”，可以优先从 Cherry Studio 开始。

一、准备 JiaPi 参数

二、下载 Cherry Studio

打开 Cherry Studio 官方下载页。

按系统选择：

1. Windows 用户下载 Windows 安装包。
2. macOS 用户下载 macOS 安装包。
3. Linux 用户按官方说明选择 AppImage、deb 或 rpm 等版本。

安装完成后打开 Cherry Studio。

三、添加 JiaPi 模型服务

进入 Cherry Studio 后，按下面路径查找：

1. 打开 设置。
2. 找到 模型服务、服务商 或 Provider。
3. 点击添加服务商。
4. 选择 OpenAI、OpenAI Compatible 或 自定义 OpenAI。
5. 服务商名称填写 JiaPi。
6. Base URL 填写 https://ai-api.jiapi.com/v1。
7. API Key 填写 JiaPi API Key。
8. 保存。

不同版本的 Cherry Studio 字段名称可能不同。看到 API Host、Endpoint、接口地址 时，可以把它当作 Base URL。

四、添加模型

保存服务商后，继续添加模型：

1. 找到模型列表或模型管理。
2. 添加一个聊天模型。
3. 模型名称填写 JiaPi 当前可用模型，例如 gpt-5.4。
4. 如果有模型类型，选择聊天或 Chat。
5. 保存后把该模型设为当前会话模型。

如果 Cherry Studio 支持从服务商拉取模型，可以先尝试刷新模型列表。刷新失败时，手动添加模型名称即可。

五、验证对话是否可用

新建一个对话，选择刚才添加的 JiaPi 模型，输入：

请用三句话介绍你现在使用的模型服务，并告诉我当前对话是否已经连通。

如果能正常回复，说明配置已经成功。

六、图片相关任务怎么配置

如果你要做图片生成或图片理解，先确认 JiaPi 当前可用模型里是否包含对应能力。配置思路和聊天模型类似：

1. 先确保普通聊天模型可用。
2. 再添加图片生成或视觉模型。
3. 在 Cherry Studio 的绘图、图片或多模态功能里选择对应模型。
4. 用简单提示词测试，例如“生成一张白底产品图”或“描述这张图片内容”。

不要一开始就同时配置很多模型。先让一个聊天模型跑通，再逐步扩展，会更容易排查问题。

七、常见问题

保存后还是不能对话

检查：

1. 当前会话是否选中了 JiaPi 模型。
2. Base URL 是否填写为 https://ai-api.jiapi.com/v1。
3. API Key 是否完整复制。
4. 模型名称是否和 JiaPi 可用模型一致。

找不到 OpenAI Compatible

尝试查找这些名称：

1. OpenAI
2. 自定义服务商
3. Custom Provider
4. API 服务商
5. 兼容 OpenAI

只要能修改 Base URL，就可以按本文配置。

图片功能不能用

聊天模型能用，不代表图片模型一定能用。请确认：

1. 当前模型是否支持图片生成或视觉理解。
2. Cherry Studio 当前功能是否选择了正确模型。
3. 模型名称是否填在对应的图片功能配置里。

参考入口

• Cherry Studio 下载