Cherry Studio 接入教程：Vana 一地址三协议

§ 一个地址，先把 Cherry Studio 接上

小团队用 Cherry Studio，最常遇到的不是模型不够，而是接口地址、协议和密钥分散在不同地方。Vana API 把这件事收敛成一个思路：一个地址，三种协议，尽量少配置。对于 Cherry Studio 这类客户端，你需要知道的核心信息很简单：请求地址是 https://api.vanaapi.com，密钥在 https://vanaapi.com 的控制台创建，调用时使用 OpenAI 格式的 /v1/chat/completions。

这不是把多个服务拼成一张复杂清单，而是把协议边界说清楚。Vana API 在同一个地址上提供三种协议，其中与 Cherry Studio 对应的是 OpenAI 格式。GPT、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 以及 Grok 等模型，都可以从 Cherry Studio 通过这个格式调用。也就是说，团队不必为每一个模型家族重新学习一套接入方式。

配置动作可以保持很小：在 Cherry Studio 中添加一个 OpenAI 兼容的供应商条目，填写 Vana API 的请求地址，把控制台生成的密钥填入，再选择需要的模型。Vana API 的控制台负责密钥、余额和使用日志；https://api.vanaapi.com 只负责回应 API 请求。把这两处分开理解，接入过程会清楚很多。

• 请求地址：https://api.vanaapi.com
• 密钥、余额与使用日志：https://vanaapi.com 控制台
• Cherry Studio 使用：OpenAI 格式 /v1/chat/completions

§ 三种协议各走各的路，不必互相猜测

一个地址背后有三种协议，但它们并不是随意混用的。Vana API 对不同模型规定了对应的客户端与协议范围，这一点对小型团队尤其重要，因为文档写清楚之后，排查问题时就不需要靠猜。

Cherry Studio 走的是 OpenAI 格式，因此 GPT、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo、Grok 都在它的可用范围内。GPT 模型还可以回应 /v1/responses，那是 Codex 使用的路径。如果团队里同时有人在用 Codex，同一个 Vana API 地址仍然可以承接，但客户端和路径要按各自规定来写。

另外两种协议有各自明确的适用范围，不能当成 OpenAI 格式的替代品随意套用。Vana API 的做法是保留协议差异，同时只给出一个地址。这样做的好处是，团队成员拿到地址和密钥后，先确认自己使用的客户端，再决定走哪条路径。少配置的前提，是规则明确，而不是把不兼容的组合混在一起。

对于日常使用 Cherry Studio 的小团队来说，这意味着配置可以沉淀成一份内部说明。新同事加入时，只需要知道地址、密钥位置和所用模型，不必再逐个询问接口细节。Vana API 把复杂性留在协议边界内，把界面留给模型选择。

§ 按真实 token 计费，账目可以逐条回看

Vana API 采用预付余额，按真实 token 计费，没有月费。密钥在控制台创建，每一次调用都会记录在使用日志中。对需要控制成本的小团队来说，这种结构比先承诺一个固定额度再月底核对更直接：花多少，取决于实际输入和输出。

以 GPT-6.1 Sol 为例，Vana API 的价格是每百万 token 输入 ¥1.00、输出 ¥6.00，官方标价为每百万 token 输入 ¥14.4、输出 ¥72。换成 GPT-5.6 Sol，Vana API 为每百万 token 输入 ¥2.50、输出 ¥13.00，官方标价为每百万 token 输入 ¥28.8、输出 ¥144。

再往上一层，GPT-6 Astra 在 Vana API 的价格是每百万 token 输入 ¥5.00、输出 ¥25.50，官方标价为每百万 token 输入 ¥72、输出 ¥360。下面的例子只是演示如何读价格：假设你每天固定处理一批文档，用 GPT-6.1 Sol 时，就按实际 token 量对照 ¥1.00 与 ¥6.00 两个数字估算，而不是套用一个与使用方式无关的月度总额。

赠送与推荐规则也写在明面上。注册赠送 ¥0.50 额度；你邀请的人付费后，你获得其付费金额的 14%，再下一层为 5%，收益满 ¥100.00 可以提现。充值后 3 天内，未使用余额可以退款，退款金额扣除已使用部分和支付处理商手续费。看清这三条规则，团队再决定充值节奏会更从容。

§ 常用模型的价格与模型标识

Cherry Studio 里选择模型时，除了价格，也可以顺手核对模型标识。下面这些模型都支持通过 OpenAI 格式接入，价格单位均为每百万 token，括号内依次为输入与输出。

• GPT-5.6 Sol，模型标识 gpt-5.6-sol：Vana API ¥2.50 / ¥13.00，官方标价 ¥28.8 / ¥144
• GPT-6 Astra，模型标识 gpt-6-astra：Vana API ¥5.00 / ¥25.50，官方标价 ¥72 / ¥360
• GPT-6.1 Sol，模型标识 gpt-6.1-sol：Vana API ¥1.00 / ¥6.00，官方标价 ¥14.4 / ¥72
• Grok 4.7，模型标识 grok-4.7：Vana API ¥3.50 / ¥11.00
• DeepSeek V4 Flash，模型标识 deepseek-v4-flash：Vana API ¥2.00 / ¥7.50
• DeepSeek V4 Pro，模型标识 deepseek-v4-pro：Vana API ¥8.00 / ¥24.00
• GLM-5.3，模型标识 glm-5.3：Vana API ¥4.00 / ¥12.00
• Kimi K3，模型标识 kimi-k3：Vana API ¥7.50 / ¥37.50
• Qwen3.7 Plus，模型标识 qwen3.7-plus：Vana API ¥0.92 / ¥3.00
• Qwen3.8 Max，模型标识 qwen3.8-max：Vana API ¥5.00 / ¥15.00
• MiniMax M3，模型标识 MiniMax-M3：Vana API ¥1.00 / ¥4.00
• MiMo V2.6 Pro，模型标识 MiMo-V2.6-Pro：Vana API ¥1.50 / ¥2.50

这份清单适合放进团队的内部选型表。日常问答、代码辅助和文档处理可以先看价格较低的选项，复杂任务再切到输出价格更高的模型。Vana API 的价值不在于替代你的判断，而在于把每个模型的实际单价摆出来，让切换模型这件事有依据。

§ 需要固定用量时，再考虑 30 天方案

按量付费适合用量波动明显的情况。如果团队的需求相对固定，Vana API 也提供 30 天方案：GPT 最多 $2,750 / 30 天，价格为 ¥746.00 / 30 天，每周最多 $820，且仅限 GPT 模型。

这个方案适合已经在 Cherry Studio 中稳定使用 GPT 的团队。它把使用窗口和上限写清楚，避免每天重新估算。但要注意，它只覆盖 GPT 模型；如果你的工作流同时依赖 DeepSeek、Qwen 或其他系列，按量付费仍然是更灵活的补充。

无论选择哪一种，Vana API 的操作路径都保持一致：在控制台创建密钥并查看余额，在 Cherry Studio 中填写同一个请求地址，按模型标识选择模型，再回到控制台查看使用日志。一个地址、三种协议、少量设置，这就是把 Cherry Studio 接入 Vana API 的完整轮廓。