Sonnet 5.5 中转站 Vana API 一小时教程
§ 一个地址如何同时支持三种协议
Vana API 的设计从一开始就围绕一个原则展开：所有模型请求都发往同一个地址 https://api.vanaapi.com。这个地址只响应 API 请求，而密钥管理、余额查询、用量日志和充值都在主站 https://vanaapi.com 的仪表盘里完成。这意味着你不需要为不同的模型分别记忆不同的域名或端口。
在这个统一地址上，Vana API 同时承载三种协议。Claude 系列模型只能通过官方 Claude Code 或 Claude Desktop 接入，且版本需为 2.1.285 或更高，它们内部使用 Anthropic Messages 协议（/v1/messages）。Gemini 系列模型只能通过 Gemini CLI 接入，走的是 Gemini 原生协议（/v1beta/models/...），并非 OpenAI 兼容格式。其余模型则使用 OpenAI 格式（/v1/chat/completions），其中 GPT 模型还额外支持 /v1/responses 接口。
把这些放在一起看，配置工作被压缩到了最小。你只需要记住一个 API 地址，然后根据模型选择对应的官方客户端即可，协议细节由 Vana API 在同一个入口内处理。
§ 注册、密钥与 ¥0.50 赠金
打开 https://vanaapi.com 注册账号后，系统会自动赠送 ¥0.50 的体验额度。这笔额度可以直接用于第一次 API 调用，无需先充值。登录仪表盘后，你可以在密钥页面创建新的 API 密钥，密钥生成后立即生效，可以直接填入客户端使用。
Vana API 采用预付费余额模式，严格按实际消耗的 token 计费，不收取任何月费。每次充值后，你的余额变动和每一次 API 调用都会详细记录在仪表盘的用量日志中，包括模型名称、输入输出 token 数量和扣费金额。如果你在充值后 3 天内没有用完余额，可以申请退还未使用部分，系统会扣除已使用金额和支付通道手续费后返还。
推荐机制也很简单：你邀请的朋友消费，你获得其支付金额 14% 的返利，朋友再邀请他人，你还能获得下一级 5% 的返利。返利收益累计满 ¥100.00 后即可申请提现。
§ Claude Sonnet 5.5 的具体接入步骤
如果你想在第一小时内用上 Claude Sonnet 5.5（模型 ID 为 claude-sonnet-5-5），需要准备官方 Claude Code 或 Claude Desktop，版本不低于 2.1.285。在这两个客户端中，将 API 基础地址设置为 https://api.vanaapi.com，并填入你在 Vana API 仪表盘创建的密钥。请注意，Claude 模型只能通过官方客户端接入 Vana API。
在请求中指定模型 ID 为 claude-sonnet-5-5。该模型在 Vana API 的定价为输入每百万 token ¥8.50，输出每百万 token ¥41.50，对照官方列表价 ¥14.4 / ¥72。按量付费的模式下，你只为实际使用的部分付费。
保存配置后，第一次对话就可以直接开始。客户端会自动与 https://api.vanaapi.com 建立连接并走 Anthropic Messages 协议，你只需要像平时一样输入问题即可。
§ 第一小时内的用量核对与账单
发出第一个请求后，回到 https://vanaapi.com 的仪表盘，打开用量日志，你就能看到刚才那次调用的完整记录：使用的模型、输入和输出各消耗了多少 token、本次扣费多少。Vana API 按真实 token 计费，没有额外月费，也没有隐藏收费项，日志里的数字和余额扣减是一一对应的。
比如说你每天都运行几次对话（这只是一个举例），每次调用的费用会实时累加，余额不足时仪表盘会提醒你充值，充值到账后即可继续使用。所有历史记录都保留在用量日志里，方便你按天或按模型核对支出。
如果你希望固定支出，Vana API 也提供月度计划，例如 Claude 最多 $1,000 / 30 天的方案价格为 ¥466.00 / 30 天，每周上限 $320，仅限 Claude 模型。对于初次尝试，按量付费配合 ¥0.50 赠金通常已足够完成第一小时的测试。
§ 为什么这个单一地址值得长期使用
回顾这一小时的流程：注册账号、领取 ¥0.50 赠金、创建密钥、在 Claude Code 或 Claude Desktop 2.1.285 及以上版本中填入 https://api.vanaapi.com、发出 Claude Sonnet 5.5 的第一个请求，最后在仪表盘的用量日志里确认扣费。整个过程只涉及一个 API 地址和一个管理地址，没有多余的配置步骤。
Vana API 将三种协议收敛到同一个入口背后，让不同模型各归其位又互不干扰。对于需要在多种模型之间切换的使用者来说，这种设计省去了反复修改地址和密钥的麻烦，也让用量和费用始终集中在一个地方查看。