Gemini CLI 中转站：Vana API 3 天退款说明

日常活儿ZH2026-11-03

§ 一个地址，三种协议：先把接入理清

Vana API 的接入思路可以先记住一句话：一个地址，三种协议，尽量少的设置。所有 API 请求统一发往 https://api.vanaapi.com，而密钥、余额和使用日志都在主站 https://vanaapi.com 的控制台里。这个地址只处理 API 请求，控制台不在同一个地址上，配置时把两者分开理解会省下不少时间。

同一个地址下对应三种协议。Claude 模型只从官方 Claude Code 或 Claude Desktop 使用，版本需要 2.1.285 或更高，这两个客户端本身就说 Anthropic Messages（/v1/messages）。Claude 模型不适用于其他任何客户端、任何 SDK、cURL 或脚本，这一点与其余两种协议差别明显。

Gemini 模型只从 Gemini CLI 使用，走 Gemini 原生协议（/v1beta/models/...），它不是 OpenAI 兼容格式。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 使用的就是这条路径。

所以如果你在用 Gemini CLI，需要做的动作很简单：在控制台创建密钥，把请求地址填成 https://api.vanaapi.com，选择对应的模型 id，然后按 Gemini 原生协议发起请求。Vana API 不要求额外的地址池，也不需要为不同模型切换入口。

§ Gemini CLI 的按量付费示例

下面是一个明确标注的示例。假设你每天用 Gemini CLI 处理文本，单日用量为输入 1,000,000 tokens、输出 100,000 tokens。Vana API 按每百万 tokens 的输入与输出价格分别计费，没有月费，扣的是真实 token 对应的金额。

Gemini 2.5 Flash（gemini-2.5-flash）：输入 ¥1.50，输出 ¥11.50。示例合计 ¥1.50 + ¥11.50 × 0.1 = ¥2.65。
Gemini 3.8 Flash（gemini-3.8-flash）：输入 ¥7.50，输出 ¥33.50。示例合计 ¥7.50 + ¥33.50 × 0.1 = ¥10.85。
Gemini 3.1 Pro（gemini-3.1-pro）：输入 ¥10.00，输出 ¥57.00。示例合计 ¥10.00 + ¥57.00 × 0.1 = ¥15.70。
Gemini 4 Argon（gemini-4-argon）：输入 ¥10.50，输出 ¥49.50。示例合计 ¥10.50 + ¥49.50 × 0.1 = ¥15.45。

同一组用量换模型，差异直接来自价格表本身。以这个示例来看，Gemini 3.8 Flash 与 Gemini 2.5 Flash 的差额是 ¥10.85 - ¥2.65 = ¥8.20；Gemini 3.1 Pro 与 Gemini 4 Argon 的差额是 ¥15.70 - ¥15.45 = ¥0.25。先算清楚单日量级，再决定用哪个模型，比事后再看账单更省事。

这个示例只演示计费方式，不代表任何固定用量。Vana API 的价格表以每百万 tokens 的输入与输出两档列出，你在控制台看到的使用日志会以实际调用为准，逐条记录每次请求。

§ 余额、用量日志与密钥分别在哪里

Vana API 采用预付余额的方式：你先充值，再用余额支付调用费用，没有月费。每次调用都会出现在控制台的使用日志里，因此“今天花了多少”这个问题不需要估算，直接看日志记录即可。

密钥同样在控制台创建。地址和密钥各司其职：https://api.vanaapi.com 负责回答 API 请求，https://vanaapi.com 负责管理密钥、余额和使用日志。把这两处分开，排查问题时不会把控制台页面当成接口地址去调用。

注册后会赠送 ¥0.50 额度。这笔金额适合用来跑通一次最小请求，确认 Gemini CLI 的地址、密钥和模型 id 都填对了，再做正式充值。对刚开始使用 Vana API 的人来说，先用小额验证链路，比一次性充值较多金额更稳妥。

§ 充值与 3 天内退款怎么算

再看一个充值示例。假设你在控制台充值 ¥100.00，当天用掉了前面那个 Gemini 2.5 Flash 示例的 ¥2.65，那么未使用余额是 ¥100.00 - ¥2.65 = ¥97.35。这个数字就是退款计算的基础。

Vana API 的退款规则是：充值后 3 天内，未使用的余额可以退款，扣除已经使用的部分和支付处理方的手续费。因此在这个示例里，退款金额是 ¥97.35 再减去支付处理方手续费，实际到账金额以支付处理方的结算为准。已使用的 ¥2.65 不退，因为这部分对应已经发生的调用。

如果时间超过充值后的 3 天，就不在这个退款窗口内。余额怎么花，建议结合前面的示例先估一遍日用量：输入 1,000,000 tokens、输出 100,000 tokens 在不同 Gemini 模型下的费用并不相同，把常用模型的单日金额算出来，再决定充值多少，剩余额度的处理方式也就更清楚了。

§ 推荐返佣：14%、5% 与 ¥100.00 提现门槛

推荐计划同样可以写成算式：你邀请的人实际支付金额的 14% 归你，往下一层的 5% 也归你，收益可以从 ¥100.00 起提现。举例说明，假设你直接邀请的人支付了 ¥100.00，对应收益是 ¥100.00 × 14% = ¥14.00；再往下一层的人支付了 ¥200.00，对应收益是 ¥200.00 × 5% = ¥10.00；两层合计 ¥14.00 + ¥10.00 = ¥24.00。

这个示例中的 ¥24.00 还没有达到 ¥100.00 的提现门槛，所以暂时不能提现，需要继续累积。Vana API 的余额、充值记录和使用日志都在控制台，推荐收益也按同一套真实支付金额计算，不涉及月费，也不影响你按 token 付费的结算方式。

§ 把 Gemini CLI 用户常问的几件事放在一起

问：Gemini CLI 需要单独准备一个中转地址吗？答：不需要。Vana API 的三个协议共用一个地址，Gemini CLI 直接指向 https://api.vanaapi.com 即可，密钥在控制台创建。

问：怎么知道余额还剩多少？答：控制台里直接查看余额和使用日志，每次调用都会列出记录。注册赠送的 ¥0.50 也可以先用来跑通一次请求，确认链路无误。

问：退款和推荐收益会互相影响吗？答：退款按充值后 3 天内未使用的余额计算，扣除已使用部分和支付处理方手续费；推荐收益按被邀请人实际支付金额的 14% 与下一层的 5% 计算，达到 ¥100.00 后可提现。两条规则各自独立。

问：为什么说接入步骤少？答：地址只有一个，协议按客户端区分，Gemini CLI 对应 Gemini 原生协议，其余 OpenAI 格式模型对应 /v1/chat/completions，GPT 模型还能走 /v1/responses。剩下的动作就是创建密钥、填地址、选模型 id，Vana API 的准备工作到这里就结束了。