文档

文档

Cherry Studio

Cherry Studio 为每种协议分别设置自定义服务商的根地址,包括 OpenAI、Anthropic 和 Gemini。粘贴密钥并填写这些根地址后,点击 Sync Models,模型目录就会自动填入选择器。

Settings → Model Services → 自定义提供商:粘贴密钥和 API 地址,点击 Get Model List,整个目录就会填充到选择器中。

Cherry Studio
设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm
“同步模型 / Sync Models” 会使用你填写的字段根地址和输入的密钥调用 GET /v1/models,因此这也是验证这组信息是否正确的最快方法——列表为空,几乎总是密钥或地址有误,而不是服务商配置问题。
每个端点字段都应填写根地址,而非完整的端点 URL。Cherry Studio 会自行附加版本段(如果根地址已以版本号结尾,则会跳过,因此 OpenAI 字段填写 https://api.kunavo.com 或 https://api.kunavo.com/v1 都能正确解析),随后始终会附加该字段对应的路由。若粘贴以 /chat/completions 或 /messages 结尾的完整端点 URL,路由就会被重复附加,请求将返回 404。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Cherry Studio 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 打开设置 → 模型服务,然后点击添加自定义提供商。
  3. 填写 API 密钥,并在 OpenAI 端点字段中输入 https://api.kunavo.com/v1。
  4. 同时填写 Anthropic 字段(https://api.kunavo.com)——它位于 端点设置 中的 OpenAI 字段下方。Cherry Agent 以及通过 Anthropic Messages 协议路由的任何模型都专门使用此字段,而非 OpenAI 字段。其他端点类型位于更多设置中。
  5. 保存后,在服务商的模型列表中点击同步模型,添加所需的聊天模型;再点击检测进行端到端验证。
  6. 为每个助手单独分配模型,而不是全局设置——Cherry Studio 会为每个助手保留各自的模型,因此便宜的默认模型和昂贵的专家模型可以并存。

已于 2026年10月1日对照 Cherry Studio 服务商文档检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Cherry Studio 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 Cherry Studio 中的位置
claude-sonnet-5$1.40 / $7.00日常使用的助手
claude-opus-5$3.50 / $17.50专门用于处理难题的助手
claude-haiku-4-5$0.70 / $3.50翻译、摘要及其他高频任务
gpt-5-6-terra$0.70 / $4.20长篇文档和大段粘贴的上下文
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

常见问题

如何向 Cherry Studio 添加自定义 API 服务商?

打开“设置” → “模型服务”(设置 → 模型服务),然后点击“添加自定义提供商”(添加自定义提供商)。每种端点类型都需要单独的根地址——默认显示 OpenAI 和 Anthropic;OpenAI Responses、Gemini 和图像端点位于“更多设置”(更多设置)中——以及一个 API 密钥。输入密钥和所需端点的根地址,点击“同步模型”(同步模型)获取模型目录,添加所需模型,然后使用“检测”(检测)确认其中一个模型可以正常工作。

为什么 Cherry Studio 的 Sync Models 没有返回内容?

该按钮会使用你输入的密钥调用 OpenAI 字段的 /v1/models 路由,因此结果为空,说明问题出在该字段的地址或密钥,而不是 Cherry Studio。每个字段都应填写根地址,Cherry Studio 会自行附加版本和路由;请检查是否误填了完整端点 URL(例如已以 /chat/completions 结尾的 URL),然后用 curl 测试同一组信息:返回 JSON 表示问题出在应用中;401 表示密钥有误。

Cherry Studio 端点字段末尾的 # 有什么作用?

Cherry Studio 自身的文档说明,这个符号可将字段固定到特定路径,适用于路由格式不符合标准的端点。Kunavo 的 OpenAI 和 Anthropic 端点都采用标准格式,因此无需使用它——填写根地址即可,可带或不带你自己的 /v1,其余部分交由 Cherry Studio 附加。

Cherry Studio 不使用 Anthropic 账户也能调用 Claude 模型吗?

可以,只要网关提供这些模型即可——请将 Kunavo 地址填写在 Anthropic 字段中,而不是 OpenAI 字段,因为 Cherry Agent 以及通过 Anthropic Messages 协议路由的任何模型都会读取该字段。Cherry Studio 会将模型 ID 发送到服务商条目指定的端点,由该端点解析 Claude ID;Cherry Studio 持有的唯一凭据就是该端点的密钥。