简短回答
在 Cherry Studio 中使用 APIVAI:打开 Settings → Model Services,点击 + Add Provider,命名为 APIVAI,把 OpenAI 端点地址填为 https://api.apivai.com(Cherry Studio 会自动补上 /v1/chat/completions)。把 APIVAI 密钥粘贴到 API Key,通过 Get model list 或 + 按钮添加 claude-sonnet-4-6、gpt-5.5 等模型 ID,然后打开该服务商开关,在对话中选择模型即可。如果想用 Anthropic 原生格式调用 Claude,也可以把内置 Anthropic 服务商的 API Address 改成同一个 https://api.apivai.com。截至 2026-10-07,通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22,官方价为 $3.00 / $15.00,从预付余额按 token 扣费。
Cherry Studio 是什么?
Cherry Studio 是一款免费的桌面 AI 客户端,支持 Windows、macOS 和 Linux。它提供带助手的对话窗口、模型选择、知识库、MCP 工具,以及多个模型并排回答。Cherry Studio 本身不带模型:你用 API 密钥接入服务商,每条消息都由该服务商计费。
APIVAI 就是这样的服务商。一个 APIVAI 密钥可以调用 Claude 和 GPT 模型,同时支持 OpenAI 格式和 Anthropic 格式,按 token 计费且低于官方标价。因此在 Cherry Studio 里只需一个服务商条目,就能在同一个模型列表中使用 Claude Sonnet 4.6、Claude Opus 5.5 和 GPT-5.5。
应该用哪种服务商设置?
在 Cherry Studio 中接入 APIVAI 有两种清晰的方式:
| 自定义服务商(OpenAI 端点) | 内置 Anthropic 服务商 | |
|---|---|---|
| 位置 | Settings → Model Services → + Add Provider | Settings → Model Services → Anthropic |
| 地址 | https://api.apivai.com | https://api.apivai.com |
| 模型 | Claude 和 GPT | 仅 Claude |
| 适合 | 一个条目覆盖所有模型 | 以原生 Messages 格式使用 Claude |
选择自定义服务商:想用一个密钥同时使用 Claude 和 GPT,大多数人选这个即可。选择 Anthropic 服务商:只用 Claude 并且偏好原生格式,例如 Cherry Studio 中需要 Anthropic 协议端点的功能。两种可以用同一个密钥同时配置。
当前版本的 + Add Provider 对话框会显示独立的端点字段(默认是 OpenAI 和 Anthropic,更多在 More Settings 中)。Cherry Studio 文档没有说明同一服务商下的模型如何在两个端点之间选择,所以本文在那里只填写 OpenAI 端点,Claude 原生格式则通过内置 Anthropic 服务商接入。旧版本会让你选择 Provider Type,选 OpenAI 即可。
如何一步步把 Cherry Studio 接入 APIVAI?
第 1 步:获取 APIVAI 密钥
- 在 apivai.com 用邮箱注册。
- 充值余额,$10 起,支持银行卡、加密货币、支付宝或微信支付。没有订阅,也没有免费试用,只按实际使用的 token 付费。
- 打开控制台,创建密钥并复制。可以为该密钥单独设置预算上限。
第 2 步:把 APIVAI 添加为自定义服务商
- 点击左侧导航栏的 Settings(齿轮图标)。
- 打开 Model Services 标签页。
- 点击服务商列表下方的 + Add Provider。
- 按下表填写对话框,然后点击 Add。
| 字段 | 值 |
|---|---|
| Provider Name | APIVAI(任意你认得出的名称) |
| API Key | 你的 APIVAI 密钥 |
| OpenAI 端点(API Address) | https://api.apivai.com |
关于 /v1:Cherry Studio 需要的是基础地址,会自己补上版本号和路径,因此 https://api.apivai.com 实际请求的是 https://api.apivai.com/v1/chat/completions。当前版本填 https://api.apivai.com/v1 也不会重复添加,但千万不要粘贴带 /v1/chat/completions 的完整地址。地址末尾加 # 表示让 Cherry Studio 原样使用该地址,接入 APIVAI 不需要这样做。
第 3 步:添加模型
- 在列表中打开刚创建的 APIVAI 服务商。
- 点击 Get model list。Cherry Studio 会拉取你的密钥可用的模型,在需要的模型旁点击 +。只有添加过的模型才会出现在模型选择器中。
- 如果想手动输入,点击 + 并填写模型 ID,例如
claude-sonnet-4-6、claude-haiku-4-5或gpt-5.5。
模型列表会随时间变化,请以 Get model list 或价格页上的 ID 为准,不要照抄旧截图。
第 4 步:测试并启用
- 点击 Test(部分版本叫 Check)并选择一个模型。提示成功说明密钥和地址都正确。
- 用服务商页面右上角的开关启用它。已启用的服务商在列表中会显示绿点。
- 打开对话,在顶部的模型下拉菜单中选择模型并发送消息。
可选:通过内置 Anthropic 服务商使用 Claude
在 Model Services 中打开 Anthropic,把 APIVAI 密钥粘贴到 API Key,并把 API Address 从 https://api.anthropic.com 改成 https://api.apivai.com。不要加 /v1,地址格式与 Anthropic 官方一致。然后点击 Get model list,添加需要的 Claude 模型并启用该服务商。GPT 模型在这里不可用,请通过第 2 步的自定义服务商使用。Anthropic 格式的更多说明见 Claude API 代理页面。
在 Cherry Studio 中该选哪个模型?
每百万 token 价格,截至 2026-10-07。全部模型见价格页。
| 模型 | 模型 ID | 输入 | 输出 | 适合 |
|---|---|---|---|---|
| Claude Sonnet 4.6 | claude-sonnet-4-6 | $1.04 | $5.22 | 日常默认,写作和代码 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | $0.69 | $3.47 | 更新的 Sonnet,擅长编程 |
| Claude Haiku 4.5 | claude-haiku-4-5 | $0.35 | $1.74 | 快速提问、翻译、摘要 |
| Claude Opus 5.5 | claude-opus-5-5 | $1.39 | $6.96 | 最难的分析和推理 |
| GPT-5.5 | gpt-5.5 | $0.77 | $4.56 | 通用对话的 GPT |
| GPT-6 Sol | gpt-6-sol | $0.30 | $1.52 | 更新的 GPT,适合高要求任务 |
| GPT-6 Luna | gpt-6-luna | $0.0144 | $0.0768 | 最便宜,适合简单任务 |
比较实用的搭配是:默认助手用便宜的 Claude Haiku 4.5 或 GPT-6 Luna,主力助手用 Claude Sonnet 4.6,只有真正需要时才用 Claude Opus 5.5。Cherry Studio 可以把同一个问题同时发给多个模型,这是在自己的任务上对比模型的低成本方法。
用 APIVAI 时 Cherry Studio 要花多少钱?
Cherry Studio 本身免费,你只为 token 付费。每条消息都会重新发送之前的对话,所以对话越长,每轮越贵。Thinking 默认开启,思考 token 按输出计费。
- 日常对话: 假设每轮约 3,000 输入 token(你的消息加最近的历史)和 800 输出 token。用 Claude Sonnet 4.6 一轮花费 $0.0073(官方价 $0.021)。每天 40 轮、持续 30 天(共 1,200 轮),一个月是 $8.76,官方价为 $25.20。同样一个月用 Claude Haiku 4.5 为 $2.93,用 GPT-6 Luna 为 $0.126。
- 处理长文档: 你粘贴一份约 30,000 token 的报告,再追问 10 个问题,每次重新发送约 31,000 输入 token,返回 1,500 输出 token。用 Claude Sonnet 4.6 这次会话花费 $0.401(官方价 $1.16)。
想省钱,换话题时就新开一个话题,并给 Cherry Studio 单独建一个带预算上限的密钥。控制台会列出每次请求的 token 和费用。更全面的价格对比见 Claude API 价格对比。
Cherry Studio 的知识库能用 APIVAI 吗?
对话可以完全通过 APIVAI 使用,但知识库需要嵌入(embedding)模型来索引文件,而 APIVAI 不提供 embeddings。要使用知识库,请在 Cherry Studio 中为它另外配置一个嵌入模型服务商;负责回答的助手仍然可以是 APIVAI 的 Claude 或 GPT 模型。APIVAI 也不提供图像生成模型。
排错
- 401 或 “invalid API key”: 密钥复制不完整、已被删除或已用完预算。从控制台重新复制,并检查余额。
- 404: 地址填错了。自定义服务商填
https://api.apivai.com,不要带/chat/completions,末尾也不要加#。Anthropic 服务商填https://api.apivai.com,不要带/v1。 - 找不到模型: 模型 ID 必须完全一致,例如
claude-sonnet-4-6,而不是显示名称。用 Get model list 查看密钥可用的模型。GPT 模型在 Anthropic 服务商下会失败,请加到自定义服务商中。 - 对话的模型选择里没有该模型: 服务商开关没打开,或者拉取了列表但没有点模型旁边的 +。
- 回复为空或被截断: 思考 token 也计入输出上限。在助手的 Edit Assistant → Model 标签页中,关闭 Enable message length limit (MaxToken),或把它设为 4096 以上。
- 回复一次性出现或流式输出中断: 检查同一标签页中的 Streaming output (Stream) 开关,以及 Cherry Studio 网络设置中的代理。
- 429: 每个密钥默认每分钟 60 次请求。同时对比多个模型会消耗多次请求;稍等片刻,或联系客服提高限额。
全部端点和错误码见文档。
常见问题
Cherry Studio 里应该选 OpenAI 还是 Anthropic?
Claude 和 GPT 一起用,就选带 OpenAI 端点的自定义服务商。只有想以 Anthropic 原生格式使用 Claude 时,才用内置 Anthropic 服务商。
地址需要带 /v1 吗?
不需要。填 https://api.apivai.com,Cherry Studio 会自动加上 /v1 和请求路径。不要填带 /v1/chat/completions 的完整地址。
一个密钥能同时用 Claude 和 GPT 吗?
可以。一个 APIVAI 密钥适用于价格页上的所有模型,两种格式都支持。同一个密钥也能用于 Chatbox 和其他 OpenAI 兼容工具。
APIVAI 会保存我的聊天记录吗?
不会。请求和响应内容不记录日志,只保留用于计费的使用数据,例如模型、token 数和费用。聊天记录保存在你电脑上的 Cherry Studio 里。
有免费试用吗?
没有。预付费、按量计费,$10 起充,无订阅。
注册账号,充值 $10 起,把密钥粘贴到 Cherry Studio 即可。