Vana API 接入教程：Cline 计费示例全流程
§ 一个地址，三种协议，设置简单
Vana API 把所有模型放在同一个地址后面：https://api.vanaapi.com。这个地址只应答 API 请求，密钥、余额和用量日志都在主站 https://vanaapi.com 的控制台里管理。你不需要为不同模型准备不同的入口，也不需要在多个平台之间切换。三种协议在同一个地址上并存：Anthropic Messages、Gemini 原生协议，以及 OpenAI 兼容格式。对于 Cline 这样的客户端，走的是 OpenAI 格式，也就是 /v1/chat/completions。
这样的安排让接入保持简单。你只需要记住一个 API 地址，然后在控制台里创建密钥，就可以开始调用。Vana API 不收取月费，采用预付费余额的方式，按真实消耗的 token 计费。每一次调用都会记录在控制台的用量日志里，你可以随时查看具体的输入和输出 token 数量以及扣费明细。整个过程不需要复杂的配置，地址只有一个，协议自动适配。
比如说你在本地安装了 Cline，打开设置面板后，只需要把 Base URL 改成 https://api.vanaapi.com，再选择一个 OpenAI 兼容模型，就完成了接入。Vana API 不会要求你搭建中间层，也不会要求你修改客户端代码。密钥在控制台一键生成，复制粘贴即可使用。
§ 示例流程：从注册到创建第一个密钥
假设你刚听说 Vana API，想在 Cline 里试用并了解计费方式。首先访问 https://vanaapi.com 注册账号，注册时会获得 ¥0.50 的赠送额度，这笔额度可以用来熟悉计费流程，看看用量日志是如何记录的。登录后进入控制台，点击创建 API 密钥。这个密钥就是你在 Cline 里配置时需要填写的凭证，妥善保存即可。整个过程不需要预付大额费用，小额充值就能开始使用。
控制台里可以看到当前余额、历史用量和每次调用的详情。Vana API 的计费是透明的：每次请求结束后，系统会按照模型的定价扣除相应费用，并同步更新到用量日志中。你不需要估算月度账单，因为没有固定月费，只有实际使用才扣款。用量日志会保留每一条记录，方便你核对 Cline 里的使用情况。
注册完成后，你可以先充值一个小金额，比如说 ¥10.00，然后就可以在 Cline 里发起第一次请求。这次请求的费用会立即从余额中扣除，并在用量日志里生成一条记录。通过这条记录，你可以清楚地看到输入 token 和输出 token 各是多少，以及本次扣费的具体金额。
§ 在 Cline 中配置模型与地址
Cline 支持 OpenAI 兼容格式，因此可以直接对接 Vana API。在 Cline 的设置里，把 API 地址填写为 https://api.vanaapi.com，选择 OpenAI 兼容模式，填入刚才在控制台创建的密钥。模型方面，Cline 可以使用 Vana API 提供的 GPT、DeepSeek、Grok、GLM、Kimi、Qwen、MiniMax、MiMo 等模型，它们都走 /v1/chat/completions 接口。
比如说，你可以选择 gpt-6.1-sol，它的定价是输入 ¥1.00 / 百万 token，输出 ¥6.00 / 百万 token。或者选择 deepseek-v4-flash，输入 ¥2.00 / 百万 token，输出 ¥7.50 / 百万 token。在 Cline 里切换模型只需要修改配置里的模型 ID，不需要改动地址或密钥。这种灵活性让你可以根据任务复杂度选择合适的模型，而不必担心接入复杂度增加。
如果你习惯使用其他 OpenAI 兼容模型，比如 glm-5.3（输入 ¥4.00 / 百万 token，输出 ¥12.00 / 百万 token）或者 MiniMax-M3（输入 ¥1.00 / 百万 token，输出 ¥4.00 / 百万 token），同样可以在 Cline 里直接填写对应的 model id。所有这些模型都在同一个地址 https://api.vanaapi.com 上应答，你不需要为每个模型单独配置 endpoint。
§ 计费如何记录：用量日志详解
每次 Cline 通过 Vana API 发起请求，控制台的用量日志都会新增一条记录。记录里包含时间、模型 ID、输入 token 数、输出 token 数和本次扣费金额。Vana API 按真实 token 计费，不会多扣，也不会少扣。假设你每天都运行同样的任务，比如说每天消耗 10 万输入 token 和 2 万输出 token，使用 gpt-6.1-sol，那么每天的费用就是 (10 万 × ¥1.00 / 百万) + (2 万 × ¥6.00 / 百万) = ¥0.10 + ¥0.12 = ¥0.22。这个例子只是为了说明计费方式，实际用量以用量日志里的真实记录为准。
如果你使用的是 qwen3.7-plus，定价是输入 ¥0.92 / 百万 token，输出 ¥3.00 / 百万 token。同样是 10 万输入和 2 万输出，费用会更低，大约是 ¥0.092 + ¥0.06 = ¥0.152。所有模型的价格都在控制台和官网上明确列出，Vana API 不会在价格之外加收其他费用。预付费余额在扣减时会实时更新，你可以在控制台随时查看剩余额度，余额不足前系统会提醒，你可以随时充值。
用量日志不仅记录费用，还能帮你分析使用习惯。比如你可以对比不同模型在同一任务下的 token 消耗，从而选择性价比更合适的方案。Vana API 的定价公开透明，例如 gpt-5.6-sol 的官方定价是 ¥28.8 / ¥144，而在 Vana API 上是 ¥2.50 / ¥13.00。这种对比可以帮助你做出更经济的选择。
§ 余额管理：充值、退款与推荐奖励
充值在 https://vanaapi.com 的控制台进行，支持预付费充值。如果你在充值后 3 天内决定不使用，未使用的余额可以申请退款，退款金额会扣除已经使用的部分和支付渠道的手续费。退款申请在控制台提交，处理完成后款项会原路返回。这种政策让你可以放心尝试，不用担心充值后无法退出。
推荐奖励方面，你邀请的人通过你的链接注册并充值时，你可以获得 14% 的分成；他们再邀请的人充值，你还可以获得 5% 的分成。推荐收益会累计在你的账户中，满 ¥100.00 后可以申请提现。提现没有额外手续费，收益直接打入你的账户。
对于用量稳定且主要使用 GPT 模型的用户，Vana API 还提供月付计划：¥746.00 可享 30 天 GPT 用量，每月额度上限 $4,000，每周最多 $1,200，仅限 GPT 模型使用。这个计划适合有固定预算的团队，但个人开发者通常按量付费更灵活，因为没有月费，用多少付多少。