CherryStudio
在 CherryStudio 桌面客户端中接入 Fast AI。
适合人群
桌面端多模型用户
希望在一个桌面应用里统一管理聊天、模型与知识库。
主要环境
Desktop
适合把 Fast AI 作为 CherryStudio 的模型提供商长期使用。
官方文档
特点与使用场景
特点
桌面端多模型客户端，适合统一管理提供商、会话、知识库与模型清单。
适用场景
你希望直接在桌面应用里和模型对话，而不是主要通过终端或 IDE 使用代理工具。
第 1 步：安装 CherryStudio
1
下载桌面客户端
优先从官方 Releases 页面下载对应系统的安装包；如果你需要更完整的安装说明，也可以先看官方文档。
2
启动并进入服务商设置
打开 CherryStudio，进入模型服务商或提供商设置页面，确认可以新增一个自定义提供商。
第 2 步：添加 Fast AI 服务商
CherryStudio 官方 NewAPI 文档的配置方式适用于 Fast AI。核心就是新增一个 OpenAI 兼容提供商，并填入 Fast AI 的 Key 与根地址。
为什么这里不写 /v1
按 CherryStudio 官方 NewAPI 文档，服务地址填写根地址即可，让客户端自行拼接接口路径。和部分 CLI 直接填写
/v1 的习惯不同，这里不要额外补 /v1。1
新增提供商
在服务商列表底部点击“添加”，备注名称可以填写
Fast AI，提供商选择 OpenAI。2
填写 API Key 与服务地址
把你在 Fast AI 控制台创建的 API Key 粘贴进去，服务地址填写根地址。
CherryStudio 提供商配置
Provider: OpenAI
Name: Fast AI
Base URL: https://api.fastai.run
API Key: sk-fastai.run-...第 3 步：添加模型并启用
1
同步或手动添加模型
可以点击“管理”尝试自动获取模型，也可以手动补充你要使用的模型名称。
2
打开服务商开关
确认模型列表无误后，打开右上角的服务商开关，让 CherryStudio 开始使用 Fast AI。
第 4 步：验证连接
1
发起一次简单对话
任选一个已启用模型发送测试消息，例如“你好，Fast AI”。如果可以正常回复，说明配置已生效。
2
回到控制台确认请求记录
如果 Fast AI 控制台出现对应请求记录，说明 CherryStudio 已通过当前提供商配置成功接入。
常见问题
提示鉴权失败
先确认 API Key 是否完整、是否仍处于有效状态，再确认复制时没有多带空格或换行。
模型列表为空
先检查服务地址和 Key 是否保存成功，再尝试点击“管理”重新拉取模型；必要时可以手动输入模型名。
请求返回 404 或地址异常
优先检查服务地址是否误填成了 `${apiBaseUrl}/v1`。按 CherryStudio 的 NewAPI 说明，这里通常只需要根地址。