接入 CherryStudio
一句话结论：CherryStudio 走 OpenAI 兼容协议。
在「设置 → 模型服务」里添加一个自定义服务商，填 API 地址（到 /v1 层级）与密钥，获取模型后打开启用开关即可。
| 项目 | 值 |
|---|---|
| 入口 | 设置 → 模型服务 → 列表下方 + 添加 |
| 服务商类型 | OpenAI / OpenAI 兼容 |
| API 地址 | https://api.ziai.lol/v1 |
| API 密钥 | ZiAI 密钥（sk- 开头），支持多 Key 轮询 |
| 生效方式 | 点「检测」验证 + 打开右上角启用开关 |
-
打开设置
在 CherryStudio 界面左侧导航栏点击设置（齿轮图标）。
-
进入「模型服务」
在设置页选择 模型服务 选项卡，你会看到内置服务商列表。
-
点击列表下方的「+ 添加」
弹出「添加提供商」对话框。
-
填写提供商信息
- 提供商名称：
ZiAI（起个自己认得的名字） - 提供商类型 / 接口格式：选择 OpenAI（即 OpenAI 兼容）
保存后它会出现在左侧服务商列表中，点击进入详情页。
- 提供商名称：
-
填写 API 密钥
粘贴
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。内置服务商通常只需填密钥，但 ZiAI 是自定义服务商，API 地址也必须填（见下一步）。
-
填写 API 地址
https://api.ziai.lol/v1填到
/v1层级即可，不要粘贴完整的/v1/chat/completions—— CherryStudio 会在你填的地址后自动补上/chat/completions。 -
获取模型列表并加入模型
点击 获取模型列表 按钮，CherryStudio 会拉取 ZiAI 支持的模型。 在弹出的「模型管理」列表里，点模型右侧的
+把它加入你的模型列表。 -
点击「检测」验证连通性
点 检测 按钮并选择一个对话模型（配置多个密钥时还可选择用哪个密钥检测）。 检测通过说明地址、密钥、模型三者都正确。
若检测失败，先检查模型列表里是否有填错的或不受支持的模型。
-
打开右上角的启用开关
-
开始使用
回到对话界面，在模型选择器里选中刚加入的模型即可。
API 地址填错时的三种形态
Section titled “API 地址填错时的三种形态”不同 CherryStudio 版本对地址的处理略有差异。以「检测」按钮的结果为准，按下面顺序试：
| 尝试 | API 地址填法 | 说明 |
|---|---|---|
| ① 首选 | https://api.ziai.lol/v1 |
客户端自动补 /chat/completions |
| ② 若 404 | https://api.ziai.lol |
部分版本会自行补上版本路径 |
| ③ 最确定 | https://api.ziai.lol/v1/chat/completions# |
以 # 结尾表示不再自动拼接，只用你填的完整地址 |
CherryStudio 支持一个服务商配置多个密钥并轮询使用（按列表从前到后循环）：
- 快速添加：多个密钥用英文逗号分隔直接填入，如
sk-xxx1,sk-xxx2,sk-xxx3 - 密钥管理：点 API 密钥输入框右侧的钥匙图标（悬停显示「API 密钥管理」），每个密钥独立条目，可分别编辑标签、启用/禁用、复制、删除
多密钥的典型用途：把 ZiAI 上按用途分开的几个密钥（如 日常、test）都放进来做负载分摊；或不同分组的密钥各配一个。
API 设置（高级）
Section titled “API 设置（高级）”部分服务商可在「API 设置」里开启特定能力，一般无需改动：
| 选项 | 作用 |
|---|---|
| 支持数组格式的 message content | 多模态消息格式兼容 |
| Developer Message | 使用 developer 角色而非 system |
enable_thinking |
控制部分模型的思考开关 |
service_tier |
仅 OpenAI 官方适用 |
再加一个 Anthropic 类型服务商（可选）
Section titled “再加一个 Anthropic 类型服务商（可选）”如果你要用 CherryStudio 的 Cherry Agent 功能，官方文档注明：Cherry Agent 需要 Anthropic 兼容类型的服务商。 此时再添加一个服务商：
- 设置 → 模型服务 → + 添加
- 提供商名称：
ZiAI-Anthropic - 类型 / 接口格式：选择 Anthropic
- API 地址：
https://api.ziai.lol（Anthropic 协议不带/v1） - API 密钥：同一个 ZiAI 密钥
- 获取模型列表 → 检测 → 打开启用开关
ZiAI 同时提供 Anthropic Messages 端点，所以这一个密钥可以喂给两种类型的服务商，按场景选用。
界面「检测」按钮最快。命令行独立验证 ZiAI 侧：
curl https://api.ziai.lol/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -d '{"model":"模型ID","messages":[{"role":"user","content":"你好"}]}'