Cherry Studio API 设置 — 添加提供商与地址

在 Cherry Studio 中设置 API 的路径是 Settings → Model Provider → Add Provider。输入 API Key，在 Endpoint settings 的 OpenAI 和 Anthropic 栏中分别输入根地址，然后保存，用“Sync models”导入模型，再用“Check”验证即可。首先需要知道：Cherry Studio 没有韩语 UI，因此菜单保留英文原文。本页面基于 2026 年 9 月 30 日发布的 v2.1.4；v2 中供应商添加界面发生了重大变化，因此 v1 时代的“Type: OpenAI”说明已不再符合当前界面。

目标是CherryHQ/cherry-studio的桌面版本（AGPL-3.0，Windows、macOS、Linux）。截至 2026 年 10 月 1 日，仓库未归档，最新版本为 v2.1.4。App Store 中同名的应用来自其他开发者，与此无关。内置 UI 语言有 13 种，不包括韩语（依据 v2.1.4 的 UI 翻译文件），因此本文假设使用英文 UI。

分步设置

Cherry Studio v2.1.4（英文界面）

Settings → Model Provider → Add Provider
  (대화상자 제목: Add Custom Provider)

  Provider Name       Kunavo
  API Key             sk-kn-...
  Endpoint settings
    OpenAI            https://api.kunavo.com/v1
    Anthropic         https://api.kunavo.com
  More options
    OpenAI Responses            https://api.kunavo.com/v1   (선택)
    Image Generation Base URL   https://api.kunavo.com/v1   (선택)
    Gemini                      비워 둠

→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"

在Settings → Model Provider中点击Add Provider。打开的对话框标题为“Add Custom Provider”。如果需要 Coding Plan 类服务、多个账户或项目隔离，也可以通过上方的“Start from a preset (optional)”从现有预设开始。
输入Provider Name和API Key。
Endpoint settings中默认有OpenAI和Anthropic两个栏。至少需要填写一个文本端点（留空会出现“Configure at least one text endpoint”错误）。填写两个栏后，除了聊天，还可以在 Agent 或使用 Anthropic 格式的功能中选择模型。
展开More options后，可以看到 OpenAI Responses、Gemini、Image Generation Base URL、Image Edit Base URL 栏。不使用的栏请留空。
保存后确认该供应商已启用（Enable）。官方文档说明，仅设置但未启用的供应商不会出现在模型选择列表中。这是“密钥不起作用”最常见的原因。
在模型列表中使用Sync models导入模型，添加要使用的模型，然后用Check验证其中一个。

地址填写方式：只填根地址

根据 v2.1.4 源码，每个栏都应填写根地址。如果没有版本部分，会自动添加/v1（已有时不会添加），随后追加该栏的固定路径。每个栏下方都会显示最终 URL 的“Request path”，请在保存前确认。

栏位	Cherry Studio 追加的路径	Kunavo
OpenAI	`/chat/completions`	支持
Anthropic	`/messages`	支持
OpenAI Responses（More options）	`/responses`	支持
Image Generation Base URL（More options）	`/images/generations`	支持
Image Edit Base URL（More options）	`/images/edits`	支持
Gemini（More options）	`/models/{model}:generateContent`	不支持，留空

常见错误有两种。粘贴包含/chat/completions或/messages的完整 URL 会导致路径重复并返回 404。末尾的#按照界面说明是“Add # at the end to disable the automatically appended API version”，也就是用于关闭自动追加 API 版本的符号；将其添加到标准端点会导致缺少/v1。要检查地址和密钥本身，下面的命令最快。

Sync models 为空时检查密钥和地址

curl https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY"

节省费用的基本模型设置

Cherry Studio 不仅在聊天时调用模型，后台也会调用。Quick Model按照界面说明用于“为对话命名和提取搜索关键词等简单任务”，提示也建议“选择轻量模型，避免使用推理模型”。将便宜的模型设置在这里，可以避免每次对话都运行昂贵模型。还要单独设置Translate Model。一次选择多个模型提问时，会按模型数量分别发送请求并分别计费。应用的用量统计金额是按公开价格换算的估算值，在折扣路径下会高于实际金额。将模型设置中的单价改为实际价格即可校正。详情请参阅英文页面Cherry Studio API cost。

使用 Kunavo 时的注意事项和支付

验证范围：本设置根据 Cherry Studio 源码和官方文档编写，Kunavo 并未实际验证 Cherry Studio 是否能连接并运行在其自有端点上。请保留当前路径进行测试。
仅聊天和图片：Kunavo 没有嵌入模型，因此知识库的向量搜索需要其他供应商或本地嵌入模型。官方文档说明，即使没有嵌入模型，知识库也会通过 BM25 关键词搜索运行。
MCP 工具：在 Settings → MCP Servers 中添加的工具，需要使用支持工具调用的模型。上面添加的 Claude 和 GPT 模型支持该功能。
付款：采用无月费的预付充值模式，按 token 从余额中扣款。最低充值金额为 $10；Stripe 结账支持银行卡（Visa、Mastercard、American Express、JCB、UnionPay）、Apple Pay、Google Pay 和 Link。如果结账页面以韩元显示，还会提供 KakaoPay、Naver Pay、PAYCO、Samsung Pay 以及被禁止进行境外支付的韩国本地银行卡作为选项（新增于 2026 年 10 月 3 日，目前尚无通过这些方式完成的付款）。金额以美元确定，韩元显示金额由 Stripe 换算，其汇率包含由付款方承担的 2–4% 换汇费。不支持 Toss Pay。请查看付款说明并创建账户以获取密钥。英文设置页面为Cherry Studio integration guide。

常见问题

如何在 Cherry Studio 中设置 API？

点击 Settings → Model Provider → Add Provider，会打开“Add Custom Provider”对话框。填写 Provider Name 和 API Key，在 Endpoint settings 的 OpenAI 和 Anthropic 栏中输入根地址，然后保存。接着在模型列表中使用“Sync models”导入模型，添加要使用的模型，并用“Check”验证其中一个。供应商必须已启用（Enable），模型才会出现在选择列表中。

可以将 Cherry Studio 设置为韩语吗？

UI 不支持韩语。v2.1.4 中的 UI 语言有英语、中文（简体和繁体）、日语、德语、法语、西班牙语、葡萄牙语、俄语、希腊语、罗马尼亚语、土耳其语和越南语，共 13 种。由于菜单通常使用英语，本页面保留英文菜单名称。与模型对话时可以使用韩语。

API 地址需要添加 /v1 吗？

可以添加，也可以不添加。v2.1.4 源码会在输入的根地址不含版本（/v1）时自动添加，已有时则保持不变，然后追加各栏路径（OpenAI 为 /chat/completions，Anthropic 为 /messages）。应避免粘贴包含 /chat/completions 的完整 URL，否则路径会重复并返回 404。末尾的 # 用于关闭自动添加版本，不要用于标准端点。可以在栏下方的“Request path”中确认最终 URL。

点击 Sync models 后仍然没有模型怎么办？

该按钮会使用输入的地址和密钥请求供应商的模型列表（/v1/models），因此为空通常是地址或密钥问题。确认没有粘贴完整 URL，末尾没有 #，然后用相同的地址和密钥运行 curl。如果返回 JSON，是应用问题；如果返回 401，是密钥问题。

Cherry Studio 免费吗？

桌面社区版是 AGPL-3.0 开源软件，因此免费。需要付费的是您配置的供应商的模型使用费。Cherry Studio Enterprise 是单独报价的产品，内置 CherryAI 虽然免费，但模型配置和限额没有公开。

2026 年 10 月 1 日核验：GitHub API（CherryHQ/cherry-studio，v2.1.4）、v2.1.4 的 UI 翻译文件列表和英文 UI 字符串（en-us.json）、供应商添加界面源码、Cherry Studio 官方文档。Kunavo 未在其自有端点上运行 Cherry Studio。