Vana 接入教程：GPT-6 Astra 按量付费 ¥5.00
§ 一个地址，三种协议
很多接入教程会把人先挡在“该用哪个地址、哪种协议”上。Vana API 的做法相反：所有模型请求都发往同一个地址 https://api.vanaapi.com。这个地址只负责应答 API 请求；密钥、余额和用量日志则在主站 https://vanaapi.com 的 dashboard 里。把这两个位置分清楚，接入的起点就不会走偏。
在同一个地址上，Vana API 提供三种协议。选哪一种，取决于你要用的模型和你手上的客户端，而不是取决于你愿意填多少参数。下面这条对应关系可以直接照着执行。
- Claude 系列模型只能通过官方 Claude Code 或 Claude Desktop 调用，并且客户端版本需要在 2.1.285 或更高，因为这两个客户端自己就会说 Anthropic Messages（/v1/messages）。
- 它们不适用于任何其他客户端、任何 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 用的就是这条路径。
本文要讲的 GPT-6 Astra 属于 OpenAI 格式这一类。所以你在 Cursor、Cline 或一个 OpenAI SDK 里换掉 base URL 和模型名，就能开始用它，不需要为它单独学习一套协议。
如果你的日常习惯是终端命令行，那么任何 OpenAI SDK 或 cURL 都够用；如果你更习惯图形化编辑器，Cursor、Cline、Roo Code、OpenCode 和 Cherry Studio 都能填入同一组参数。换句话说，先确定你已经在用的工具，再去对应协议，而不是反过来先研究协议。
§ 在 dashboard 准备密钥与余额
Vana API 使用预付余额模式：先充值，再调用，按真实 token 计费，没有月费。注册时还有 ¥0.50 的赠送额度，可以先用它跑通一次请求，确认链路和模型名都正确，再决定后续充值金额。
密钥在 dashboard 里创建，调用时放进请求头。Vana API 的每一次调用都会写进 dashboard 的用量日志，你可以逐条查看用了哪个模型、输入输出各多少 token、花了多少钱。对刚开始接入的人来说，这条记录比任何猜测都更直接。
充值节奏也由你控制。Vana API 按真实 token 计费，用多少扣多少，因此小额多次充值和一次充足都可以，dashboard 里的用量日志会逐条记录每次调用，核对时按时间查看即可。
账务规则同样写在明处。充值后 3 天内，未使用的余额可以退款，扣除已经用掉的部分和支付处理商的手续费。邀请方面，你邀请的人所支付金额的 14% 归你，再往下五层的 5% 也归你，收益累计到 ¥100.00 即可提现。
§ 用 OpenAI 格式调用 GPT-6 Astra
GPT-6 Astra 的模型 id 是 gpt-6-astra。把 base URL 指向 https://api.vanaapi.com，路径用 /v1/chat/completions，模型名填 gpt-6-astra，再带上 dashboard 创建的 key，最小配置就完成了。在 Cursor 或 Cline 里，选 OpenAI 兼容的提供商，填入同样的地址和密钥；在 OpenAI SDK 里，把 base_url 换成这个地址即可。
如果你更习惯直接写代码，把客户端的 base_url 指向 https://api.vanaapi.com，路径使用 /v1/chat/completions，模型名填 gpt-6-astra，认证方式沿用你熟悉的 OpenAI 方式，密钥用 dashboard 里创建的那一把。整个过程不需要额外的代理设置，也不需要为不同模型更换地址。
价格按每百万 token 计算：GPT-6 Astra 在 Vana API 的输入价是 ¥5.00，输出价是 ¥25.50；官方标价为 ¥72 / ¥360。同一地址下切换模型只需要改模型名，所以先用 GPT-6 Astra 验证一次调用，再决定长期使用哪个 GPT 模型，流程是一样的。
举例来说，假设你每天调用 1,000 次，每次输入 1,000 token、输出 500 token，一天就是 1,000,000 输入 token 和 500,000 输出 token。按上面的单价计算，输入 ¥5.00，输出 ¥12.75，合计 ¥17.75。这个例子只用于说明计费方式，实际用量以 dashboard 的用量日志为准。
§ Codex 与 /v1/responses
如果你用 Codex 写代码，GPT 模型在 /v1/responses 上的应答已经就绪，Codex 走的就是这条路径。地址仍然是 https://api.vanaapi.com，不需要额外的中转地址或另一套密钥。Vana API 在这一点上的取舍很简单：能说同一种协议的模型，就让它们共用同一个入口。
把 Codex 当作主要入口时，路径换成 /v1/responses 即可，地址和密钥都不变。Vana API 在这里没有额外分支：GPT 模型能在两种 OpenAI 风格路径上应答，Codex 和你自己的脚本可以并存。
同一地址下还有别的 GPT 模型可选。GPT-6.1 Sol 的模型 id 是 gpt-6.1-sol，输入 ¥1.00、输出 ¥6.00，官方标价 ¥14.4 / ¥72；GPT-5.6 Sol 的模型 id 是 gpt-5.6-sol，输入 ¥2.50、输出 ¥13.00，官方标价 ¥28.8 / ¥144。三者的调用方式完全一致，差别只在价格，你可以先用 GPT-6 Astra 跑通链路，再按任务选择。
§ 月度套餐与用量上限
如果你的用量稳定，也可以看一下月度套餐。GPT 最多 $2,750 / 30 天 的套餐为 ¥746.00，有效期 30 天，每周最多 $820，只覆盖 GPT 模型。套餐适合节奏固定的日常使用；如果调用量忽高忽低，预付余额按量付费更贴合实际，两种方式都在同一个 dashboard 里管理。
需要留意的是，套餐与协议是两件事。上面这个 GPT 套餐只覆盖 GPT 模型；如果你日后换成 Gemini 系列模型，就只能在 Gemini CLI 中使用，对应的是 Gemini 原生协议，而不是 OpenAI 格式。选模型之前先确认客户端，调用才不会走弯路。
回头看整个流程，Vana API 的接入其实只有三件事：在 dashboard 创建密钥并充值，把客户端的 base URL 指向 https://api.vanaapi.com，按模型与协议的对应关系填入模型名。一个地址、三种协议、尽量少的设置，这就是 GPT-6 Astra 的五分钟上手路径。