Cherry Studio 接入星空 API

本页是文字教程

下图是配置流程示意，实际按钮以你的客户端版本为准。希望跟着实拍截图逐步操作，可以使用 Chatbox 图解。

按顺序操作

1. 打开 https://www.cherry-ai.com/，进入下载页，选择 macOS 版本。若区分芯片，在 Mac 左上角苹果菜单 →“关于本机”查看是 Apple 芯片还是 Intel。
2. 下载后打开安装包，按提示把 Cherry Studio 拖入“应用程序”，再从那里启动。
3. 点击设置齿轮，进入 模型服务。
4. 若有“添加”入口，添加一个名为“星空 API”的 OpenAI 兼容服务商；也可使用能修改地址的 OpenAI 配置项。
5. 填写完整 Key 和 API 地址，并打开该服务商的启用开关。
6. 点击 管理 / 获取模型 / 添加模型，选择或手动添加真实模型 ID。
7. 若有“检查”功能，可先检查连接，但一次聊天才是更完整的验证。
8. 返回聊天页，创建会话或选择助手，在模型选择器里选刚添加的模型，发送“你好”。

这三项填什么

配置项	填什么
API 地址 / Base URL	通常填写 https://cdn.api.inxk.com，由客户端补上 /v1；若当前界面示例包含 /v1，按示例填 https://cdn.api.inxk.com/v1
API Key	星空完整 Key，不带 Bearer
Model	当前分组允许的真实模型 ID
服务商类型	OpenAI 兼容；不要使用不可修改地址的内置付费服务

没成功？先检查

报错或现象	排查方法
找不到新模型	打开服务商开关，添加模型，再回聊天页选择
401	重新复制完整 Key，检查是否到期或被停用
404	检查是否重复或遗漏 /v1，是否误填完整聊天接口
403 / 无模型权限	检查分组、模型 ID 和 IP 限制
检查通过，聊天失败	用短文本测试，查看真实聊天请求错误；检查模型能力和附加参数

✅ 本节完成检查点

• [ ] 星空服务商已启用，并添加了真实模型。
• [ ] 聊天页选中该模型，发送“你好”后收到回复。

收到回复了？完成最后的检查 →

仍然失败？查看排查与工单步骤 →