文档
Cherry Studio
Cherry Studio 为每种协议分别设置自定义服务商的根地址,包括 OpenAI、Anthropic 和 Gemini。粘贴密钥并填写这些根地址后,点击 Sync Models,模型目录就会自动填入选择器。
Settings → Model Services → 自定义提供商:粘贴密钥和 API 地址,点击 Get Model List,整个目录就会填充到选择器中。
设置 → 模型服务 → 添加 → 添加自定义提供商 (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 confirmGET /v1/models,因此这也是验证这组信息是否正确的最快方法——列表为空,几乎总是密钥或地址有误,而不是服务商配置问题。https://api.kunavo.com 或 https://api.kunavo.com/v1 都能正确解析),随后始终会附加该字段对应的路由。若粘贴以 /chat/completions 或 /messages 结尾的完整端点 URL,路由就会被重复附加,请求将返回 404。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Cherry Studio 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 打开设置 → 模型服务,然后点击添加自定义提供商。
- 填写 API 密钥,并在 OpenAI 端点字段中输入
https://api.kunavo.com/v1。 - 同时填写 Anthropic 字段(
https://api.kunavo.com)——它位于 端点设置 中的 OpenAI 字段下方。Cherry Agent 以及通过 Anthropic Messages 协议路由的任何模型都专门使用此字段,而非 OpenAI 字段。其他端点类型位于更多设置中。 - 保存后,在服务商的模型列表中点击同步模型,添加所需的聊天模型;再点击检测进行端到端验证。
- 为每个助手单独分配模型,而不是全局设置——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 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 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 | 长篇文档和大段粘贴的上下文 |
常见问题
如何向 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 持有的唯一凭据就是该端点的密钥。