VanaAPI

← 文章

Haiku 4.5 接入教程:Vana 充值赠 ¥0.50 额度

模型名册ZH2026-11-03

§ 一个地址,三种协议

接入一个模型服务时,真正容易出错的往往不是模型本身,而是地址、协议和调用方式这三件事没有对齐。Vana API 把它们分得很清楚: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 上应答。协议不需要你额外申请,地址也不需要按模型更换,这正是 Vana API 强调的一个地址、三种协议、设置很少。

本文以 Claude Haiku 4.5 为主线,完整走一遍从准备到调用的示例流程。文中所有场景均为示例,实际参数以你使用的官方工具版本为准。

§ 在主站准备密钥与余额

开始之前,先到主站 https://vanaapi.com 注册并创建一枚 API Key。密钥的生成位置只有控制台这一处,拿到之后复制保存即可。地址方面无需再做别的准备,https://api.vanaapi.com 直接填入需要发送请求的地方。

计费方式是预付余额,按真实 token 计费,没有月费。注册即赠 ¥0.50 信用额度,足够先跑通一次最小请求,确认地址、密钥、模型三项都对得上,再决定追加多少充值。示例来说,先用赠送额度验证一次短问答,看到内容正常返回,再按自己的实际使用量充值,支出曲线会更贴近真实消耗。

每一次调用都会列在控制台的用量日志里,余额变动可以逐条查看。对照日志核对扣费,是把成本控制在预期范围内最直接的办法。Vana API 的按量付费不附带固定月费,实际支出几乎等于你真实消耗掉的那部分。

§ 示例:接入 Claude Haiku 4.5

Claude Haiku 4.5 的接入前提是 Anthropic Messages 协议,对应的官方工具版本需要为 2.1.285 或更高。示例流程分为四步:在官方工具中把服务地址设置为 https://api.vanaapi.com;在主站复制刚创建的 API Key 并填入密钥位置;把模型指定为 Claude Haiku 4.5,其模型 ID 为 claude-haiku-4-5-20251001;保存后发起一次普通提问。

如果界面正常返回内容,说明地址、密钥、模型 ID 三项都对齐了。这次验证请求同样会出现在用量日志中,可以顺便确认计费链路是通的。

这里有一条边界需要提前知道:Claude 模型的接入范围有明确限定,Anthropic Messages 这条路径之外的调用方式都不适用。提前确认自己的使用方式落在哪条路径上,可以省掉不少反复排查的时间。示例只演示 Anthropic Messages 这一条路径,验证通过后再按同样的原则处理其他协议下的模型,不要把不同协议的模型混着填进同一个位置。

整套配置动作很轻:一次地址设置、一次密钥粘贴、一次模型选择。没有额外的账号体系需要打通,也不需要为不同协议准备不同域名。日常在多个官方工具之间切换时,地址与密钥基本是复制过去的,这就是单地址带来的直接好处。

§ 按量付费:看清每百万 token 的价格

Claude Haiku 4.5 在 Vana API 的价格是每百万 token 输入 ¥2.50、输出 ¥11.50;官方标价则是输入 ¥7.2、输出 ¥36。两组数字并排看,差距是明确的。你可以据此估算自己的日常用量:假设你每天固定做一次文档整理,示例来说,一个月的开销就等于这段时间内输入与输出 token 的总量分别乘以对应单价,再从预付余额里扣除,中间没有月费这一层固定成本。

因为按真实 token 结算,费用会随着使用强度自然伸缩。需要密集处理长文本时,输出部分的单价权重更高;日常短问答为主时,输入与输出占比更接近实际消耗。Vana API 把单价和逐条日志都摊开,让预算这件事从猜测变成可以对照的记录。

如果更习惯一次性规划额度,也可以参考下面的 Claude 专属月度套餐,它与按量付费并不冲突,按实际需要选择即可。

§ 套餐、邀请与退款规则

Claude 最多 $1,000 / 30 天对应 ¥466.00 for 30 days,每周最多 $320,仅限 Claude 模型;更高一档是 Claude 最多 $2,400 / 30 天,对应 ¥1,106.00 for 30 days,每周最多 $750,同样仅限 Claude 模型。两档都以 Claude 模型为范围,不覆盖其他模型。

邀请规则同样清楚:你邀请的人付费,你获得其付费金额的 14%;再下一层获得 5%。收益满 ¥100.00 后可以提现。示例来说,如果你把 Vana API 推荐给几位同事,他们各自充值并产生调用,你的账户里就会按层级累计相应比例的收益。

退款方面也有明确口径:充值后 3 天内,未使用余额可以退款,金额扣除已使用部分和支付处理方的手续费。早期小额试用不必一次充太多,先验证再追加,是一种稳妥的节奏。

回到最初的目标:用 Claude Haiku 4.5 跑通一次完整接入。地址只有一个,协议按模型选择,密钥在主站创建,余额按真实 token 扣除,每次调用都记录在用量日志里。Vana API 把接入过程中真正需要记住的东西压缩到很少,剩下的交给实际使用去验证。