VanaAPI
登录

← 文章

Claude Desktop接入Vana API：充值与价格说明

日常活儿ZH2026-11-02

§ 一个地址，三种协议

Vana API 的接入方式可以先记住一句话：一个地址，三种协议，尽量少的设置。所有模型请求都发往 https://api.vanaapi.com ，而密钥、余额和使用记录在主站 https://vanaapi.com 的控制台里管理。这个分工很直接，地址负责回答请求，控制台负责管理账户，两边各做一件事。

同一个地址下有三条通路。Gemini 模型走 Gemini 原生协议（/v1beta/models/...），只从 Gemini CLI 调用。GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 走 OpenAI 格式（/v1/chat/completions），可以从 Cursor、Cline、Roo Code、OpenCode、Cherry Studio、任意 OpenAI SDK 或 cURL 使用；GPT 模型同时也在 /v1/responses 上响应，Codex 使用的就是这条路径。

对于本文要谈的 Claude 模型，规则不同，也更明确：它们只接受 Anthropic Messages（/v1/messages）协议，并且只能从官方 Claude Code 或 Claude Desktop 调用。选对客户端，比记住更多参数更重要。

如果你不确定该用哪条通路，可以先看自己手上的工具是什么。工具决定了协议，协议决定了地址上的路径，这一点在 Vana API 上是统一不变的。

§ Claude Desktop 接入前的两个确认点

很多人问 Claude Desktop 接入 Vana API 会不会麻烦。实际准备集中在两个地方：客户端版本和请求地址。版本要求是 2.1.285 或更高版本，更早的版本不能直接使用 Claude 模型。确认版本之后，把 Vana API 的地址填入 Claude Desktop，再把在控制台创建的密钥复制过去，接入就完成了。

边界也需要说清楚。Claude 模型通过 Claude Desktop 或 Claude Code 自身说出的 Anthropic Messages 协议工作，它们不适用于任何其他客户端、任何 SDK、cURL 或脚本。这不是功能上的缺失，而是协议本身不同，写清楚反而省事。

所以在别的客户端里看不到 Claude 模型，往往不是配置写错了，而是协议不匹配。Gemini CLI 对应的是 Gemini 原生协议，两条路径不要混用。Vana API 把这些差异在文档层面说明白，你就不必逐个试错。

§ 充值、余额与按量计费

Vana API 采用预付余额、按真实 token 计费，没有月费。充值之后余额显示在控制台，每次调用都按实际消耗扣减；每一次调用也都会列入控制台的使用日志，方便你回头核对某次请求花了多少。

注册即送 ¥0.50 的额度，可以先拿它跑通一次请求。密钥在控制台创建，余额和使用日志也在同一个控制台里查看，这几件事都在 https://vanaapi.com 完成，而请求地址始终是 https://api.vanaapi.com 。

退款规则同样写在明处：充值后 3 天内，未使用的余额可以退款，扣除已经使用的部分以及支付处理方的手续费。也就是说，早期的小额试错成本是可控的，充值金额不必一次放得很大。

§ Claude 模型的价格对照

下面是 Claude 模型的每百万 token 价格，输入与输出分别列出，并附上官方标价供对照。Vana API 的计价单位是每百万 token：

  • Claude Fable 5.1（model id claude-fable-5-1）：Vana API ¥24.00 / ¥120.50，官方标价 ¥72 / ¥360。
  • Claude Haiku 4.5（model id claude-haiku-4-5-20251001）：Vana API ¥2.50 / ¥11.50，官方标价 ¥7.2 / ¥36。
  • Claude Opus 5.5（model id claude-opus-5-5）：Vana API ¥10.50 / ¥50.00，官方标价 ¥28.8 / ¥144。
  • Claude Sonnet 5.5（model id claude-sonnet-5-5）：Vana API ¥8.50 / ¥41.50，官方标价 ¥14.4 / ¥72。

举一个例子：假设某次调用的输入刚好是 1 百万 token，输出刚好也是 1 百万 token，那么用 Claude Sonnet 5.5 时，这次调用按 Vana API 单价就是 ¥8.50 加 ¥41.50，合计 ¥50.00。日常用量可以直接按同样的方式估算。

输入和输出分开计价这一点值得留意。上下文越长、回复越长，对应的两项费用会同时变化，所以用控制台的使用日志核对，比凭感觉估算更可靠。

§ Claude 月度方案

如果使用频率比较稳定，也可以选择按 30 天计的方案。Vana API 提供两个仅限 Claude 模型的月度方案：

  • Claude 最多 $1,000 / 30 天：¥466.00，覆盖 30 天，每周最多 $320，仅限 Claude 模型。
  • Claude 最多 $2,400 / 30 天：¥1,106.00，覆盖 30 天，每周最多 $750，仅限 Claude 模型。

月度方案与按量付费的差别在于用量上限和周期安排。用量起伏较大时，按真实 token 结算更贴近实际；用量可以预估时，月度方案的价格更直观，也省去了频繁充值的动作。

§ 邀请返佣与常见计费问题

邀请机制的比例也写明在案：你邀请的人付费，你获得其付费金额的 14%；再下一层获得 5%。收益累计到 ¥100.00 起可以提现。

常见问题可以这样理解。首先，Claude Desktop 里用不了 Claude 模型，多半是版本低于 2.1.285，或者把地址填成了控制台地址；请求地址应当是 https://api.vanaapi.com 。其次，余额扣减比预想快，可以到控制台的使用日志逐条查看，因为每次调用都会被列出来。最后，想换模型时先确认客户端与协议是否对应：Claude 走 Anthropic Messages，Gemini 走 Gemini 原生协议，其余模型走 OpenAI 格式。

把这些规则放在一处看，Vana API 的结构其实不复杂：一个地址承接请求，控制台管理密钥、余额与日志，计费按真实 token 发生。剩下的就是选好客户端，填好地址，开始使用。

再读一篇