Vana API 接入教程：Opus 5.5 月度方案与真实上限
§ 一个地址，三种协议
Vana API 的接入方式可以概括成一句话：一个地址，三种协议，尽量少的设置。下面用一个示例工作流，把从了解方案、创建密钥、配置客户端到查看用量的全过程走一遍。这只是示例，不代表每个人的用量，也不代表固定的月费结构，实际花费始终按真实 token 计算。
所有请求都发往同一个地址：https://api.vanaapi.com。这个地址只负责处理 API 请求，密钥、余额和用量日志都在主站 https://vanaapi.com 的控制台里管理。控制台与请求入口分开，意味着你不需要在不同后台之间来回切换，也不需要为每种模型家族准备一整套不同的接入配置。
所谓三种协议，是同一地址上的三条路径。Claude 模型走 Anthropic Messages，也就是 /v1/messages；Gemini 模型走 Gemini 原生协议，也就是 /v1beta/models/...；GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 走 OpenAI 格式，也就是 /v1/chat/completions，其中 GPT 模型另外还会在 /v1/responses 上响应。路径选对，模型和客户端的对应关系才不会混乱。
- Claude 模型：使用 Anthropic Messages 协议。
- Gemini 模型：使用 Gemini 原生协议，不是 OpenAI 兼容格式。
- GPT 等其他模型：使用 OpenAI 格式，GPT 模型另有 responses 路径。
需要特别说明的是，Claude 模型对客户端有明确要求：只能从官方 Claude Code 或 Claude Desktop 使用，版本需为 2.1.285 或更高，因为这两个客户端本身就说 Anthropic Messages 协议。除此之外的客户端、SDK、cURL 或脚本都不适用这条路径。这一点先记住，后面配置时会省下很多试错时间。
§ 重度工作周，先选对月度方案
如果你这周的任务量明显偏高，比如连续几天都要长上下文推理、大量代码分析或成篇的文档产出，那么月度方案比临时小额充值更贴合节奏。Vana API 的月度方案没有月费，费用来自预付余额，按真实 token 扣费，方案本身给出的是用量上限和对应价格。
Claude 相关的月度方案只有两档，都只覆盖 Claude 模型。Claude 最多 $450 / 30 天，价格为 ¥466.00 / 30 天，每周最多 $140；更高一档是 Claude 最多 $1,050 / 30 天，价格为 ¥1,106.00 / 30 天，每周最多 $320。这两档的差别，本质上是单周能承载的工作量不同：一档适合强度起伏中等的工作周，另一档适合从周一到周五都排满的重度周。
作为对照，GPT 方案是 GPT 最多 $2,750 / 30 天，价格为 ¥746.00 / 30 天，每周最多 $820，只覆盖 GPT 模型。它和 Claude 方案不通用，选哪一档取决于你在这段时间主要调用哪个模型家族，而不是取决于哪个数字更大。
周上限是硬性边界，值得在开始前就算清楚。假设你把工作周安排成每周都接近上限使用，那么整个 30 天周期内不要把额度提前用尽，否则后面几天就会被挡住。示例做法是：周一到周四按日常节奏推进，把最重的推理任务集中安排在额度充裕的日子，同时每天在控制台的用量日志里核对实际消耗。
§ Claude Opus 5.5 的实际单价
Opus 5.5 是这类重度工作周的常用选择。它的模型 id 是 claude-opus-5-5，在 Vana API 的每百万 token 价格为：输入 ¥10.50，输出 ¥50.00；作为参照，官方标价是输入 ¥28.8、输出 ¥144。输入和输出之间的差价比较大，所以输出长度直接影响账单，这一点在安排任务时值得留意。
如果你希望同一周里用更轻的模型处理部分环节，Claude 家族还有几个可选项，价格同样按每百万 token 计算。Claude Sonnet 5.5（模型 id claude-sonnet-5-5）输入 ¥8.50、输出 ¥41.50，官方标价是输入 ¥14.4、输出 ¥72；Claude Fable 5.1（模型 id claude-fable-5-1）输入 ¥24.00、输出 ¥120.50，官方标价是输入 ¥72、输出 ¥360；Claude Haiku 4.5（模型 id claude-haiku-4-5-20251001）输入 ¥2.50、输出 ¥11.50，官方标价是输入 ¥7.2、输出 ¥36。
把这些数字放在一起看，结论很朴素：重度周的主力可以是 Opus 5.5，批量、机械、上下文较短的环节可以交给更便宜的 Claude 型号，混合使用比全程只用一种型号更省。按量付费的好处也在这里，模型搭配可以随时调整，不需要重新签订任何东西。
§ 示例工作流：从注册到跑完一周
这个例子假设你接下来有 30 天的高强度使用需求，主力模型是 Claude Opus 5.5。先在主站 https://vanaapi.com 注册，注册赠送 ¥0.50 的额度，可以用来验证接入链路是否通畅。打开控制台，创建一把 API 密钥，密钥同样在控制台里生成和管理。
接着完成充值。选择 Claude 最多 $1,050 / 30 天这一档，价格 ¥1,106.00 / 30 天，每周最多 $320；如果你的强度没有那么高，改选 Claude 最多 $450 / 30 天，价格 ¥466.00 / 30 天，每周最多 $140，同样只覆盖 Claude 模型。充值完成后，余额会体现在控制台中，后续调用从余额扣减。
然后配置客户端。把 https://api.vanaapi.com 作为请求地址，协议选择 Anthropic Messages，也就是 /v1/messages，模型填写 claude-opus-5-5，密钥粘贴刚创建的那一把。客户端使用官方 Claude Code 或 Claude Desktop，版本 2.1.285 或更高。这里没有额外的中间层需要搭建，配置项就是地址、协议、模型、密钥这四项。
接下来是日常使用。把整理资料、审阅代码、撰写长文这类需要较强推理能力的任务交给 Opus 5.5；如果是大量短文本的归类、改写或摘要，可以切换到 Claude Haiku 4.5 或 Claude Sonnet 5.5 来控制成本。每完成一天的工作，回到控制台的用量日志核对一次，查看这次调用实际用了多少 token、扣了多少费用，日志里每一次调用都有记录。
到了周末做一次复盘：把日志里的消耗与你这周实际完成的任务对应起来，判断下一周是否需要更早切换到更便宜的型号，或者是否需要更高一档的周上限。因为计费按真实 token 进行，调整节奏就能直接反映在支出上。
§ 充值、退款与推荐收益
Vana API 的账目规则是预先充值、按真实 token 扣费、没有月费。每一笔调用都会出现在控制台的用量日志里，密钥也在控制台创建，因此余额和支出随时可以核对，不需要额外的对账流程。
退款规则同样明确：充值后 3 天内，未使用的余额可以退款，扣除已经使用的部分以及支付处理方的费用。如果你在测试阶段发现某个方案并不适合自己的工作节奏，这 3 天是一个可以回旋的窗口。
推荐机制也可以一并算进收益预期：你邀请的人消费后，你获得其付费金额的 14%；再下一层获得 5%。收益满 ¥100.00 后可以提现。把这些和按量付费的价格放在一起看，Vana API 的成本结构是透明的：主地址只有一个，协议按模型家族选择，密钥和用量在一个控制台里查看，剩下的就是按真实 token 结算。
回到这个示例的起点：如果你的下一周确实排得很满，那么从 Claude 最多 $1,050 / 30 天、每周最多 $320 这一档开始，配合 Opus 5.5 的 ¥10.50 与 ¥50.00 每百万 token 单价，并在每天的用量日志里核对消耗，就是一条不需要反复折腾配置的重度工作周路径。