Gemini Flash 接入教程：Vana API 一小时起步
§ 决策标准：一个地址，三种协议
选 API 中转服务时，容易卡在三个问题上：地址是否统一、协议是否写清楚、账单能不能逐条核对。Vana API 给出的答案很直接：一个地址 https://api.vanaapi.com，三种协议，最少配置。接入端只记这一个地址，管理端只用一个页面，这套结构本身就是判断是否好用的标准之一。
需要分清的是控制台和接口地址的区别。https://api.vanaapi.com 只处理 API 请求，key、余额、用量日志都在主站 https://vanaapi.com 的控制台里。把这两件事分开，意味着程序配置不会因为页面操作而变复杂，也意味着你查账时不必回到请求记录里翻找。
三种协议的归属是固定的。Claude 模型由官方 Claude Code 或 Claude Desktop（2.1.285 及以上版本）使用，它们自身使用 Anthropic Messages（/v1/messages）。Gemini 模型由 Gemini CLI 走 Gemini 原生协议（/v1beta/models/...），它不是 OpenAI 兼容格式。GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 走 OpenAI 格式（/v1/chat/completions），其中 GPT 模型还响应 /v1/responses。
把这张协议表放在手边，接入时就不会反复试错。你要做的是先确定自己要用哪个客户端，再对照协议与模型，而不是先去找一串参数。
§ 起步步骤：拿 key、认地址、填模型
在 Vana API 控制台注册后，先去创建 key。注册赠送 ¥0.50 的 credit，可以直接用来跑一次最小调用，确认链路是否通。Vana API 采用预付余额，按真实 token 计费，没有月费；也就是说，你不必先买一个订阅档期，用多少付多少。
配置时其实只有三处：
- 地址填 https://api.vanaapi.com；
- 客户端用 Gemini CLI，协议保持 Gemini 原生协议，路径是 /v1beta/models/...；
- 模型写 gemini-2.5-flash。
这三处填好，接入就完成了。这里有一个容易被忽略的细节：地址只有一个。后面如果要在同一个地址上换用其他协议家族，改的是客户端与协议，而不是重新申请一套地址。地址稳定，配置才稳定。
§ 发出首次调用：先短后长
建议用一条短提示做冒烟测试。例如你每天固定问同一类短问题（这是示例场景），先跑一次，检查返回是否正常、模型 id 是否被正确接受。首次调用的目的不是产出成果，而是确认地址、key、协议三者一致。
成本可以直接对照价格表。Gemini 2.5 Flash 每百万 token 的输入价格是 ¥1.50，输出价格是 ¥11.50。计费按真实 token 计算，短请求和长请求的费用自然不同，你不需要为“预留”付费。
换模型时只改 model id，不要改协议。Gemini 原生协议的调用路径始终是 /v1beta/models/...。把这条规则记住，整个接入教程就只剩下一次练习。
调用成功后回到控制台看一眼余额与用量日志。如果这两处数字对得上，说明你的配置是干净的，后面调换模型时也更省事。
§ 用量日志：把每一笔花费看清楚
每次调用都会记录在 Vana API 控制台的 usage log 里：调用时间、模型、token 用量与对应费用，逐条可查。判断“值不值”的时候，日志比印象可靠。
举例来说，假设你每天跑一轮固定长度的提示（这是示例场景），一周之后回到用量日志，就能看到哪一天消耗了更多输入 token、更多输出 token，以及对应的金额变化。差异会自己显出来，而不是靠估算。
因为是预付余额按真实 token 扣费、没有月费，中途停下来也不会产生月费账单。日志与余额放在一起看，你对成本的判断就有了依据，而不是一个模糊的感觉。
对初次接触 API 中转的人来说，这一步往往比挑模型更重要：先学会看账，再决定调用规模。
§ 充值、退款与邀请：规则写清楚
充值前可以先小额试用。Vana API 的退款规则是：充值后 3 天内，未使用的余额可以退款，扣除已经使用的部分以及支付处理方的手续费。规则写在明面上，适合先用小额跑通，再决定是否加量。
邀请机制同样写得清楚：被邀请人消费，你获得其消费的 14%；再下一层是 5%。收益累计到 ¥100.00 可以提现。这两个数字适合拿来做长期规划，而不是当作短期收益预期。
加上注册赠送的 ¥0.50 credit，Vana API 的起步门槛并不高。把这几个数字放在一起看：先验证链路，再小额充值，然后按用量日志调整节奏。
§ 值不值：三条判断标准
判断标准可以归纳成三条：调用是否频繁、输入输出 token 的比例如何、你是否需要明确知道每一次调用花在哪。Gemini 2.5 Flash 的输入价是 ¥1.50，输出价是 ¥11.50。如果你的场景偏短提示、高频调用，它的成本结构比较直接；如果输出很长，就要按输出价重新估算。
如果之后还需要同一地址上的其他协议家族，切换依据也很明确：Claude 走官方 Claude Code 或 Claude Desktop，GPT、Grok、DeepSeek 等走 OpenAI 格式。一个地址覆盖三种协议，减少的是配置与切换成本。
回到最开始的标准：地址统一、协议明确、日志可查。Vana API 把这三件事放在同一套流程里，接入步骤少，账单也留有痕迹。对刚开始使用 API 中转的人来说，这通常比单纯的低价宣传更有参考价值。