Cherry Studio 使用教程

适合谁

Cherry Studio 适合希望用桌面聊天界面管理多个提供商和模型、不想操作命令行的用户。

下载与安装

前往 Cherry Studio 官方下载页，选择 Windows、macOS 或 Linux 版本。安装完成后打开应用并进入 设置 → 模型服务。本文按 Cherry Studio 1.9.12 的界面说明。

准备信息

项目	内容
提供商类型	OpenAI
API 地址	https://duckmans.com
API Key	YOUR_API_KEY
模型	后台当前可用模型 ID

还没有 Key？先完成 创建 API Key。Cherry Studio 中填写的是 API Key，不是兑换码。

逐项填写

1. 在 模型服务 页面点击底部的 添加，创建 OpenAI 兼容的自定义提供商，名称填写 DuckMans。创建后在提供商列表中选择它。

进入 **模型服务**，在提供商列表中选择 **DuckMans**。

2. API 密钥填写 DuckMans 创建的 Key，API 地址填写 https://duckmans.com。当前版本会在字段下方预览 https://duckmans.com/v1/chat/completions，不要把完整请求地址重复填入 API 地址。
3. 点击 API 密钥右侧的 检测。只有应用明确提示检测通过后，才继续获取模型。配置完成后必须点击 检测，检测通过再继续。

填写 API Key 和 `https://duckmans.com`，确认地址预览以 `/v1/chat/completions` 结尾，并打开右上角服务开关。

4. 检测通过后点击 获取模型列表。选择当前 Key 实际可用的模型；如果列表没有自动加入目标模型，可点击右侧的 + 手动添加后台显示的完整模型 ID。不要照抄截图中的展示名称。
5. 确认 DuckMans 右上角的启用开关已经打开。

点击 **获取模型列表**，选择控制台当前可用的完整模型 ID，不要照抄示例显示名称。

最小测试

返回首页并新建空白会话，切换到 DuckMans，选择刚才添加的模型并发送：

你好，请只回复：DuckMans 配置成功。

收到指定回复后，再添加知识库、长提示词或额外参数。

常见问题与排错

检测失败

确认 API 地址为 https://duckmans.com，重新粘贴 Key，并检查 Key 的分组、余额和有效期。修正后重新检测，通过后再获取模型。

获取模型列表失败

确认当前 API 地址没有重复 /v1。如果最终请求出现 /v1/v1，说明地址中多写了版本路径。

能看到模型但首页无法选择

先确认已经把模型加入提供商列表，再确认 DuckMans 右上角启用开关已打开并已保存。

401、404 或一直等待

401 时确认使用的是 API Key 而不是兑换码；404 时不要把完整接口路径填入 API 地址；一直等待时可以临时关闭流式输出后重试最小消息。

安全说明

• 为 Cherry Studio 单独创建 Key，并按需设置额度或有效期。
• 不要把 Key 写入助手提示词、知识库或同步文档。
• 截图时将 Key 打码成 sk-abcd••••wxyz。
• 怀疑泄露时删除旧 Key，创建新 Key 后再更新提供商配置。