在 Cherry Studio 中使用 ZhiFlo

这条路径适合不想碰命令行的人。完成后，你会在聊天页面里看到自己添加的 ZhiFlo 模型，并收到一条真实回复。

开始前

• 已按照 Cherry Studio 官方文档安装并能打开客户端。
• 已创建一枚当前设备专用的 Token。
• 已复制账户当前可用的完整 模型 ID。

1. 添加自定义服务商

1. 打开 设置。

2. 进入 模型服务。

3. 选择 + 添加自定义服务商。

4. 将服务商类型选择为 OpenAI。

5. 将名称设为 ZhiFlo。

6. 按下表填写连接信息：

   字段	填写内容
   API 地址 / Base URL	https://api.zhiflo.com/v1
   API Key	当前设备专用的 ZhiFlo Token
   模型 ID	账户列表中的完整模型 ID

   Token 只应粘贴到客户端凭据字段，不要出现在服务商名称、模型名称或截图中。

7. 保存服务商。

8. 打开 ZhiFlo 服务商的启用开关。

保存和启用是两个动作。启用后，ZhiFlo 应出现在可用模型服务列表中。

2. 先检查，再进行实际对话

如果页面提供 检查 按钮，可以先运行它。检查通过只表示地址或凭据的基础检查完成，并不代表模型请求已经返回。

1. 回到聊天页面。

2. 在模型选择器中选择刚添加的 ZhiFlo 模型。

3. 发送：

   只回答 OK。

聊天区出现 OK，这次配置才算完成。只看到绿色检查或服务商名称，还不代表模型真的已经可用。

常见恢复动作

• 模型选择器没有 ZhiFlo：回到 模型服务，确认已经保存并打开启用开关，再核对模型 ID 已添加。
• 检查通过但聊天失败：确认聊天页当前选择的是 ZhiFlo 模型，然后核对完整模型 ID；检查按钮不能代替实际调用。
• 返回 401：重新粘贴未过期、未撤销的 Token，注意不要带前后空格。
• 返回 404：确认 API 地址为 https://api.zhiflo.com/v1，不要在 Base URL 后再加 /chat/completions。

下一步：了解 如何查看用量。