在 Cherry Studio 中设置自己的 API，路径是 設定 → 模型供應商 → 新增供應商：填入 API 密钥，在「端點設定」的 OpenAI 和 Anthropic 字段中各填入一个根地址，保存后按「同步模型」导入模型，再用「檢查」确认。本文以 2026 年 9 月 30 日发布的 v2.1.4 为准，菜单名称全部按照 Cherry Studio 繁体中文界面的原文书写。v2 大幅改动了添加供应商的界面，v1 时代「類型選 OpenAI」的教程已经不再适用。
本页指的是 CherryHQ/cherry-studio 的桌面版（AGPL-3.0，支持 Windows、macOS、Linux）。2026 年 10 月 1 日核实时，代码仓库未归档，最新版是 v2.1.4。App Store 上同名的 App 是另一位开发者推出的无关产品。此外，Cherry Studio 的官方文档是简体中文；界面切换成繁体后，「提供商／服务商」会显示为「供應商」，对照文档时不要被名称混淆。
逐步设置
設定 → 模型供應商 → 新增供應商
（對話框標題：新增自訂供應商）
供應商名稱 Kunavo
API 金鑰 sk-kn-...
端點設定
OpenAI Chat Completions https://api.kunavo.com/v1
Anthropic Messages https://api.kunavo.com
更多選項
OpenAI Responses https://api.kunavo.com/v1 （選填）
影像產生基礎 URL https://api.kunavo.com/v1 （選填）
Google Gemini 留空
→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」- 打开設定 → 模型供應商，点击新增供應商。弹出的对话框标题是「新增自訂供應商」。如果是 Coding Plan 类服务、多账号或需要按项目区分，可以使用上方的「從預設開始（選填）」基于已有预设创建。
- 填写供應商名稱和 API 金鑰。
- 端點設定默认已有 OpenAI Chat Completions 和 Anthropic Messages 两个字段，至少要设置一个文本端点。两者都填写后，聊天以外的 Agent 和使用 Anthropic 格式的功能也能选择模型。
- 展开更多選項，还有 OpenAI Responses、Google Gemini、影像產生基礎 URL、圖片編輯基礎網址。用不到的留空即可。
- 保存后，确认此供应商处于启用状态。官方文档指出，已设置但未启用的供应商，其模型不会出现在菜单中——这是“密钥没有反应”最常见的原因。
- 在模型列表中按同步模型，添加要使用的模型，再按檢查测试其中一个。
地址怎么填：只填根地址
根据 v2.1.4 源代码，每个字段填入的是根地址：没有版本段时会自动补上 /v1（已有则不补），再接上该字段的固定路径。每个字段下方都会显示「請求路徑」，那就是最终发送请求的网址。
| 字段 | Cherry Studio 接上的路径 | Kunavo |
|---|---|---|
| OpenAI Chat Completions | /chat/completions | 支持 |
| Anthropic Messages | /messages | 支持 |
| OpenAI Responses（更多選項） | /responses | 支持 |
| 影像產生基礎 URL（更多選項） | /images/generations | 支持 |
| 圖片編輯基礎網址（更多選項） | /images/edits | 支持 |
| Google Gemini（更多選項） | /models/{model}:generateContent | 不支持，留空 |
两个常见错误：一是粘贴含有 /chat/completions 或 /messages 的完整网址，导致路径重复并返回 404；二是在结尾加上 #。界面提示写得很清楚：「在結尾新增 # 以停用自動附加的 API 版本。」标准端点加上它后，/v1 就会消失。
顺手设置好，账单少一截
Cherry Studio 除了聊天之外，还会在后台调用模型。快速模型按界面说明是「用於對話命名、搜尋關鍵字提煉等簡單任務的模型」，提示也写着「請選擇輕量模型，並避免使用推理模型」。在这里放一个便宜的模型，就不会每次对话都让昂贵的模型运行一轮。翻譯模型也是单独设置的。一次选择多个模型同时提问时，每个模型都会各自发送一次请求、各自计费。App 中用量统计显示的金额是按公开价格换算的估计值，使用有折扣的路线时会偏高；在模型设置中将单价改成实际价格后就会准确。更多细节请参阅英文版 Cherry Studio API cost。
使用 Kunavo 的注意事项与台湾付款
- 验证范围：以上设置是根据 Cherry Studio 的源代码与官方文档整理的，Kunavo 没有实际将 Cherry Studio 连接到自家端点运行过。请保留你目前可用的接入方式，再尝试这一种。
- 只有聊天与图片：Kunavo 没有嵌入（embedding）模型，知识库的向量检索需要使用其他供应商或本地嵌入模型；官方文档指出，没有嵌入模型时，知识库仍会以 BM25 关键词检索运行。
- MCP 工具：在 設定 → MCP 伺服器 中添加的工具，要使用支持工具调用的模型才能调用；上面添加的 Claude、GPT 模型都支持。
- 付款：预付充值，按 token 扣费，无月费。最低充值金额为 $10，结账通过 Stripe；台湾可使用信用卡（Visa、Mastercard、American Express、JCB、银联）、Apple Pay、Google Pay 和 Link；街口、LINE Pay 不在可用列表中。请参阅计费说明，准备好后可以创建账户并生成密钥。英文设置页面为 Cherry Studio integration guide。
常见问题
如何在 Cherry Studio 中设置自己的 API？
前往 設定 → 模型供應商 → 新增供應商，打开「新增自訂供應商」对话框，填入供应商名称、API 密钥，并在「端點設定」的 OpenAI Chat Completions 和 Anthropic Messages 字段中填入根地址后保存。接着在模型列表中按「同步模型」导入模型、添加要使用的模型，再用「檢查」确认其中一个可用。供应商必须处于启用状态，否则模型不会出现在菜单中。
Cherry Studio 的 API 地址要不要加 /v1？
加不加都可以。v2.1.4 的源代码会在你填写的根地址后自动补上版本（/v1），如果已经有就不会重复；之后再加上该字段自己的路径（OpenAI 是 /chat/completions，Anthropic 是 /messages）。真正要避免的是粘贴含有 /chat/completions 的完整网址，否则路径会重复并返回 404。结尾的 # 用于「停用自動附加的 API 版本」，标准端点不要加。每个字段下方都会显示「請求路徑」，保存前看一眼即可知道最终的网址。
「同步模型」没有获取到任何模型怎么办？
这个按钮会使用你填写的地址和密钥，向供应商请求模型列表（/v1/models）。如果列表为空，多半是地址或密钥的问题，而不是 Cherry Studio。先确认没有粘贴完整网址、结尾没有 #，再用 curl 测试同一组地址与密钥：返回 JSON 代表问题在 App 中，返回 401 代表密钥不正确。
Cherry Studio 可以切换成繁体中文吗？
可以。Cherry Studio 的界面内置 13 种语言，包含繁体中文（zh-TW），在设置中的语言选项切换即可。请注意，繁体界面将服务商称为「供應商」，而官方文档和简体界面使用「提供商」「服务商」，对照教程时名称会不同，但指的是同一个东西。
Cherry Studio 要收费吗？
桌面版（社区版）是 AGPL-3.0 开源软件，免费。需要付费的是你设置的供应商所收取的模型使用费。Cherry Studio Enterprise 是另行报价的商业产品；内置的 CherryAI 免费，但模型阵容和额度没有公开。
2026 年 10 月 1 日核实：GitHub API（CherryHQ/cherry-studio，v2.1.4）、v2.1.4 的繁体中文界面字符串（zh-tw.json）与新增供应商界面的源代码、Cherry Studio 官方文档。Kunavo 没有实际使用 Cherry Studio 测试过自家端点。