Cherry Studio 的最佳 API，是能够响应你的功能所需协议的提供商，因为 Cherry Studio 本身免费且不收取任何费用：它是基于 AGPL-3.0 的开源软件，你花费的每一分钱都由端点背后的提供商收取。Cherry 自己的 API 网关文档对此说得很清楚——“使用量和费用仍由实际模型提供商产生”——因此，“Cherry Studio 定价”实际上是在问令牌费率，再乘以一些会在不知不觉中发出比你要求更多请求的默认设置。
有四种东西共用这个名称，但没有一种是免费桌面客户端。Cherry Studio Enterprise是另一款可私有部署的产品，README 按报价销售。CherryAI是内置的免费提供商。CherryIN是 Cherry Studio 作为内置提供商附带的付费网关，地址为 open.cherryin.ai。而 Apple App Store 上名为“Cherry Studio”的条目（id 6476445971）是无关开发者推出的 Health & Fitness 应用，因此不要将其视为移动版本。本文仅介绍来自 CherryHQ/cherry-studio 的桌面客户端。
在你查看任何教程之前，包括本网站上的旧教程，先注意一个版本事项。该仓库仍在维护且未归档，采用 AGPL-3.0 许可证，并拥有超过 52,000 个 stars；最近一次推送于 2026 年 9 月 21 日（GitHub API，检查于 2026 年 9 月 21 日）。v2.0.0 于 2026 年 8 月 5 日发布——比 v1 的最终版本晚两天——v2.1.0 于 2026 年 9 月 18 日发布（releases API，同次检查；最后一个 v1 版本 v1.9.13 的日期为 2026 年 8 月 3 日）。v2 中自定义提供商对话框发生了变化——原来的单个“Type: OpenAI”下拉菜单变成了按协议独立设置基础 URL。v1 时代教程中的截图和字段名称已不再匹配。
Cherry Studio 定价：软件与模型两条费用线
| 项目 | 费用 | 来源 |
|---|---|---|
| Cherry Studio 社区版（Windows、macOS、Linux） | $0，AGPL-3.0 | 仓库许可证字段和 README |
| 社区版的商业使用 | 遵守 AGPL-3.0 时为 $0；否则需通过联系获取商业许可证 | README 许可证部分 |
| CherryAI，内置的免费提供商 | $0；配额和速率限制未公开 | CherryAI 提供商文档 |
| 每次模型调用，包括通过 Cherry 的本地 API 网关发起的调用 | 你的提供商按令牌或按图像收取的费率 | API 网关文档 |
| Cherry Studio Enterprise | 另一款产品；未公布价格——见下文 | README 对比表和企业版文档 |
企业版是搜索结果容易误导的地方，因为本文抽样结果中“cherry studio pricing”排名最高的官方页面是企业版文档——但该页面完全没有公布套餐价格。其正文通过 JavaScript 渲染；2026 年 9 月 21 日的普通获取请求只返回了页面自身的描述行，其中写明按订阅计费并按令牌使用量收费，支持支付宝和银行转账。README 的版本对比也没有更具体，将企业版成本写为“Buyout / Subscription Fee”，而社区版则标注为 AGPL-3.0 许可证，并指引有兴趣者请求报价。企业版营销网站是一个 JavaScript 应用，本文无法读取其中的数字，因此这里不引用其任何金额。如果你需要企业版，请要求对方提供书面报价。
对于其他所有人，客户端是免费的，真正需要考虑的是调用费用。
比你预期收费更多的默认设置
这是价格表无法展示的部分。Cherry Studio 会分别为多个模型角色计费，而其历史压缩默认设置会悄悄让最昂贵的模型承担本不需要它的工作。
| 什么会触发请求 | 默认值 | 对账单的影响 |
|---|---|---|
| 在一条消息中比较模型 | 由你选择数量 | “同时选择多个模型会发送独立请求”——三个模型就是一个问题产生三笔费用 |
| 快速模型 | 在 Settings → Default Model 中设置 | 生成对话名称和提取搜索关键词；Cherry 的文档建议使用“便宜且快速”的轻量模型，而不是推理模型 |
| 翻译模型 | 单独设置 | 消息和页面翻译单独计费，不计入聊天模型 |
| 绘画模型 | 单独设置 | 图像生成的默认模型，由提供该模型的提供商收取费用 |
| 自动历史压缩 | 已启用，压缩模型为“Follow the current model” | 总结较早的历史记录时，除非将其指向其他模型，否则会按主模型的费率计费 |
| 模型调用重试 | 关闭；开启后，最多尝试 3 次，采用指数退避，并使用按顺序排列的备用模型 | 重试和备用机制只会在输出开始前生效，因此每次额外尝试都会向你的提供商发送另一个请求 |
| 工具输出截断 | 50,000 个字符 | 限制一次性推入提示词的工具输出量 |
内容来自 Cherry Studio 的默认模型、上下文与压缩和模型比较页面，检查于 2026 年 9 月 21 日。Cherry 关于比较功能的建议值得重申：涉及费用、速度或敏感数据时，先用一个简短问题确认，再发送长材料。
应用内费用是估算值，在折扣网关上会显示偏高
Cherry Studio 的使用统计面板会显示总费用、缓存命中率，以及过去 30 天、90 天或一年按提供商、模型、API 密钥和助手划分的明细。该总费用不是对你账户的读取结果。文档说明费用“是估算值：按照模型的公开价格进行换算”，实际计费仍由各模型提供商负责；免费模型和本地模型不会产生费用。
其结果具体而且容易被忽略：如果你以低于公开标价的价格购买同一个模型，Cherry Studio 会系统性地高估你的支出。修复方法在模型列表中——自定义提供商文档说明，你可以打开模型设置并编辑其名称、类型和价格，因此输入实际费率后，面板就能恢复正常使用。另一个值得关注的数字是缓存命中率；上面的“使用统计”页面将其定义为缓存读取命中次数除以可观测输入；在支持提示词缓存的路由上，这个比率决定了重复的长上下文能有多便宜。
Cherry Studio 两种回合形态的估算示例
以下是说明性令牌算术，不是经过测量的任务成本，也不是账单上限。假设一个简短问题包含1,500 个输入令牌和 600 个输出令牌，一个文档回合包含120,000 个未缓存输入令牌和 1,500 个输出令牌——大致相当于将一篇长论文粘贴到上下文中。费率采用实时的 Kunavo 目录每百万令牌价格。
| 模型 | 每 1M 个令牌的输入 / 输出 | 简短问题 | 文档回合 |
|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $0.0032 | $0.089 |
| GPT-5.6 Terra | $0.70 / $4.20 | $0.0036 | $0.090 |
| Claude Sonnet 5 | $1.40 / $7.00 | $0.0063 | $0.178 |
| Claude Opus 5 | $3.50 / $17.50 | $0.0158 | $0.446 |
两个结论比排名更重要。第一是扇出：在相同条件下，同时向 Claude Sonnet 5、GPT-5.6 Terra 和 Claude Haiku 4.5 提出同一个文档问题，并不是一笔费用，而是三笔费用，即 $0.358——这正是 Cherry 建议先用简短问题测试的原因。第二是压缩：假设对 60,000 个输入令牌和 1,200 个输出令牌进行一次总结，若跟随 Claude Sonnet 5，费用为 $0.0924；若指向 Claude Haiku 4.5，则为 $0.0462。单独看，这两个数字都不大；但它们会整天重复产生。
在将此作为预算之前，请根据你自己的对话规模进行换算。Kunavo 目录金额是计费底价，而不是上限：当上游报告其费用时，账单取目录成本与上游成本乘以适用加价之间的较大值。缓存费用和图像生成不包含在此示例中。最低充值金额为预付余额 $10，这是资金充值最低额，而不是任务费用或订阅费——请参阅账单详情。
Cherry Studio 的最佳 API：不同情况下哪条路由更合适
| 方式 | 适用场景 | 你放弃的内容 |
|---|---|---|
| 直接调用提供商 API | 你长期使用某家供应商的旗舰模型，并希望使用其专属的缓存和批处理条款 | 第二个供应商意味着第二个提供商条目和第二笔余额 |
| CherryIN，Cherry Studio 随附的网关 | 你想使用内置付费提供商；其已发布的模型列表同时包含 OpenAI 和 Anthropic 端点类型，无需第三方设置 | 在下面比较的 Claude 模型中，其公布费率与供应商列表中的费率一致 |
| 第三方 OpenAI 和 Anthropic 兼容网关 | 你按任务切换模型，希望使用一个密钥和一笔余额，并希望费率低于标价 | 你手动配置它；在编辑每个模型的价格之前，应用内费用估算会显示偏高 |
| CherryAI，内置的免费提供商 | 无需配置、无需付费的日常聊天 | 模型阵容、配额和速率限制均未披露，由服务器控制，并会根据 Cherry 的决定进行更改 |
| 本地模型 | 小型、私密或离线工作，不按请求收费 | 与托管前沿模型相比存在能力差距，并且需要使用你自己的硬件 |
Claude 对比是唯一有两处来源支持的对比，因此本文展示它。CherryIN 的数字根据其自己的公开定价数据、单一默认组计算得出，该组的比率为 1 且不适用折扣；四个模型的结果都与供应商费率完全一致。
| 模型 | Kunavo 目录，每 1M Token 的输入/输出 | CherryIN 公布的费率 | Anthropic 公布的费率 |
|---|---|---|---|
| Claude Opus 5 | $3.50 / $17.50 | $5.00 / $25.00 | $5.00 / $25.00 |
| Claude Sonnet 5 | $1.40 / $7.00 | $2.00 / $10.00 | $2.00 / $10.00 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $3.00 / $15.00 | $3.00 / $15.00 |
| Claude Haiku 4.5 | $0.70 / $3.50 | $1.00 / $5.00 | $1.00 / $5.00 |
CherryIN 在全部四个模型上的费率都与 Anthropic 公布的费率一致，因此整个差额都位于 Kunavo 一栏。来源包括 CherryIN 定价（根据其公开定价数据、默认组、比率 1 计算）和 claude.com/pricing，均于 2026 年 9 月 21 日读取；Anthropic 一栏中的四个数字均直接取自该页面。这里未列出 CherryIN 对 OpenAI 和 Google 模型的费率，因为无法与这些供应商自己的公开页面进行核对。更广泛的网关比较请参阅最佳 LLM 网关和OpenRouter 替代方案。
Cherry Studio 的最佳模型：按角色选择
由于 Cherry Studio 会分别为各角色计费，有用的答案是分配方案，而不是单一名称。将前沿模型只放在需要判断的地方：主助手使用 Claude Opus 5 或 Claude Sonnet 5，中等价位的替代方案使用 GPT-5.6 Terra。在 Quick 位置使用便宜、快速、非推理模型——Claude Haiku 4.5——因为它只负责生成对话名称和提取搜索关键词。翻译也采用相同策略，并将自动压缩指向便宜的模型通道，而不要让它跟随主模型。Opus、Sonnet 与 Haiku 的比较介绍了判断通常应落在哪条界线上。
选择时有两个陷阱。第一是模型 ID：Cherry Studio 不再合并名称相似的模型，并会在显示名称下方显示提供商返回的 API ID，正是为了避免你选中带日期或供应商前缀的同名模型——请复制准确的 slug，包括短横线，按照提供商写法填写。第二是知识库，其中通常的警告说得过于绝对：Cherry 的创建页面将嵌入字段默认设为“Do Not Use”，其检索设置页面说明，即使没有嵌入模型，知识库仍可使用 BM25 关键词检索——嵌入模型增加的是与其并行的向量检索。Kunavo 不提供嵌入模型，因此这部分向量检索需要来自在 Cherry Studio 中下载的本地模型或第二个提供商。LibreChat 与 Open WebUI比较了两个以相同方式将检索模型与聊天模型分开的客户端。
每个端点框中应粘贴什么
在 v2 中，自定义提供商对话框需要填写提供商名称、API 密钥，以及按协议独立设置的基础 URL：默认包括 OpenAI 和 Anthropic；通过额外端点开关，还可配置 OpenAI Responses、Gemini、图像生成和图像编辑。客户端将该折叠项标记为 更多设置 (More options)，与文档中的 More Settings 一致；更多端点 (More Endpoints) 标签属于另一种流程，用于复制预设提供商（已根据 v2.1.0 和 v2.1.4 源代码于 2026-10-01 修正）。Cherry Studio 会自行构建最终 URL——其 v2.1.0 源代码会规范化主机，在地址尚未包含版本段且不以 # 结尾时追加 /v1，然后追加协议路径。因此，https://api.kunavo.com 和 https://api.kunavo.com/v1 会指向同一位置；末尾的 # 会导致错误，因为它会完全关闭版本追加。
| 端点框 | Cherry Studio 应用追加的路径 | Kunavo |
|---|---|---|
| OpenAI | /chat/completions | 服务商 |
| Anthropic | /messages | 服务商 |
| OpenAI Responses（更多设置） | /responses | 服务商 |
| 图像生成（更多设置） | /images/generations | 服务商 |
| 图像编辑（更多设置） | /images/edits | 服务商 |
| Gemini（更多设置） | /models/{model}:generateContent | 未公开——留空 |
这些路径于 2026 年 9 月 21 日从 v2.1.0 源代码读取。如果可以，请同时填写 OpenAI 框和 Anthropic 框。Cherry 的 编码合作伙伴页面（该页面可通过 Cherry Studio 服务商启动 Claude Code、OpenAI Codex、Gemini CLI、OpenCode 及其他工具）说明，它会按照每个 CLI 所需的接口类型筛选列表，不兼容的服务商不会列出（核查于 2026 年 9 月 21 日）。Agent 运行时也会经过同一个本地网关，Cherry 自己的文档称其为 Agent 运行所需的内部服务；其 创建 Agent 页面则说明，模型选择器会筛除与所选运行模式不兼容的模型。这里没有测试你的哪些模型能通过该筛选，因此请配置两个框，不要押注于一种协议。
以下是 2026 年 9 月 21 日核查的 服务商文档中的三个操作要点。启用开关是“我的密钥无法使用”最常见的原因：已配置的服务商保持禁用状态，开启之前其模型不会出现在选择器中。获取模型列表会使用你刚输入的密钥获取服务商自己的模型列表，因此列表为空通常说明问题出在密钥或地址，而不是 Cherry Studio。一个服务商还可以保存多个密钥，并按从前到后的顺序轮换使用，这是分摊速率限制的实用方式。
完成设置后，检查第一笔费用
Kunavo 为此客户端发布了一份配置参考。这是一份已发布的设置指南，而不是兼容性测试——这里没有对 Cherry Studio 使用 Kunavo 端点进行运行时测试，上述内容全部来自 Cherry 自己的文档、其 v2.1.0 源代码以及文中注明的公开定价数据。请注意，设置文档是针对 v1 对话框编写的，并描述了一个 Type 字段；上面的 v2 流程才是当前流程。尝试时请保留一条可用路线，运行一个范围明确的任务，然后将 Cherry Studio 的估算值与账户在 用量中实际记录的数值进行比较。从 Cherry Studio 集成指南开始，准备为密钥充值时再创建 Kunavo 账户。
常见问题
Cherry Studio 的费用是多少？
Cherry Studio 桌面客户端免费。它基于 AGPL-3.0 开源，CherryHQ/cherry-studio 仓库采用该许可证；README 说明，在完全遵守 AGPL-3.0 的前提下允许商业使用，同时也提供单独的商业许可证，需联系项目方获取。你需要支付的是你在其中配置的相应提供商收取的模型费用。Cherry Studio Enterprise 是另一款可私有部署、按报价销售的产品，其条款没有说明个人运行免费桌面客户端时需要支付什么费用。
Cherry Studio 的最佳 API 是什么？
Cherry Studio 的最佳 API，是能够覆盖你所使用功能实际需要的协议、且费率在你接受范围内的 API。Cherry Studio v2 将自定义提供商配置为按协议独立设置基础 URL——默认包括 OpenAI 和 Anthropic；通过对话框中的额外端点开关，还可配置 OpenAI Responses、Gemini、图像生成和图像编辑——因此，只能通过 chat completions 响应的提供商会启用聊天窗口，却可能让 Agent 和编码 CLI 功能在选择器中被过滤掉。能够同时响应 OpenAI chat completions 和 Anthropic messages 的提供商，覆盖面最广。费率是第二个考虑因素：比较模型时，Cherry Studio 会为每个选定模型发送一个计费请求，因此每个令牌的差异会乘以你同时调用的模型数量。
Cherry Studio 的最便宜 API 是什么？
标价最低的费率和完成工作的最低成本是两个不同的问题；在 Cherry Studio 中，由于一个问题可能产生多个计费请求，这一差距尤其大。在比较每令牌费率之前，请将 Quick model 设置为便宜的轻量模型，把自动历史压缩指向便宜模型，而不要让它跟随主模型，并记住，在比较视图中选择三个模型会产生三个请求的费用。Cherry Studio 自带的 CherryAI 提供商免费，但其文档说明，模型阵容、配额和速率限制由 Cherry 的服务器实时提供并不时调整，因此无法据此进行预算。不要将任何提供商描述为绝对最低价；请根据你自己的工作负载比较各条路由。
Cherry Studio 的最佳模型是什么？
不存在唯一的最佳模型，因为 Cherry Studio 至少会分别为四种角色计费。主聊天或助手模型是前沿模型体现其费率价值的地方。Quick model 用于生成对话名称和提取搜索关键词，Cherry Studio 自己的文档建议在此使用便宜、快速、非推理模型。翻译模型和绘画模型也应分别设置，并按照相同的成本逻辑进行选择。一个实际容易踩的坑是：名称相似的模型不再合并，真正的 API 模型 ID 会显示在显示名称下方，因此应复制准确的 slug，而不是标签。
为什么 Cherry Studio 的费用显示与我的提供商收取的费用不一致？
因为它是根据公开标价计算的估算值，而不是读取你的账户。Cherry Studio 的使用统计文档明确说明，费用“是估算值：按照模型的公开价格进行换算”，实际计费仍由各模型提供商负责。因此，如果你通过折扣网关购买，应用内数值就会偏高。修复方法在模型列表中：Cherry Studio 允许你打开模型设置并编辑其名称、类型和价格，因此填入实际的每令牌费率后，估算值就会恢复一致。无论如何，都应与提供商自己的使用记录进行核对。
Cherry Studio 的知识库可以运行在仅支持聊天的提供商上吗？
可以，但要注意检索质量。Cherry Studio 自己的“创建知识库”页面建议首次使用者将嵌入模型设置为 [Do Not Use]，其模型与检索页面则说明，即使没有嵌入模型，知识库仍可使用 BM25 关键词检索；嵌入模型增加的是与 BM25 并行运行的向量检索。如果你确实需要向量检索，文档提供了两条路线——使用能够提供嵌入模型的服务中的云端嵌入模型，或在“设置”→“本地模型”下下载本地嵌入模型。Kunavo 不提供嵌入模型，因此这部分向量检索必须来自本地模型或第二个提供商。
Claude Pro 或 Max 订阅可以在 Cherry Studio 内使用吗？
不能作为提供商使用。Claude Pro 和 Max 是聊天订阅，不会发放 API 密钥，因此没有任何内容可粘贴到 Cherry Studio 的提供商条目中；Anthropic 公布的 Pro 价格为年度订阅每月 $17、预付 $200，或按月计费 $20；Max 则从每月 $100 起（claude.com/pricing，检查于 2026 年 9 月 21 日）。Cherry 的文档确实介绍了 Coding Partner 页面，该页面会启动 Claude Code 等外部 CLI，由 CLI 使用其自己的账户登录——但这只能在该 CLI 内使用，不能在 Cherry Studio 的聊天窗口中使用。
核查于 2026 年 9 月 21 日：CherryHQ/cherry-studio 仓库及发布 API、README、上面链接的 Cherry Studio 文档页面、CherryIN 的公开定价数据、claude.com 发布的订阅和 API 费率，以及 Cherry Studio v2.1.0 的端点路径源代码。没有为 Cherry Studio Enterprise 报价，因为两个官方页面都没有发布可通过普通抓取读取的价格。Kunavo 的令牌费率来自实时目录；本页面中的每个美元示例都是说明性的令牌算术，而不是实测任务成本；此处没有任何内容经过针对 Kunavo 端点的运行时测试。