Codex接入Vana API教程：按量付费，一个地址搞定
§ 一个地址，三种协议
把 Codex 接到模型上，真正需要理解的事情并不多。Vana API 的核心结构是：一个地址，三种协议，极少的设置。所有 API 请求都发往 https://api.vanaapi.com，而 key、余额与用量日志放在主站 https://vanaapi.com 的控制台里。这个分工很直接：程序只管请求，人只管管理。
所谓三种协议，是指同一个地址会按不同的请求格式回应不同模型。GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 使用 OpenAI 格式，也就是 /v1/chat/completions；GPT 模型同时支持 /v1/responses，Codex 走的正是这条路径。Claude 模型使用 Anthropic Messages，也就是 /v1/messages。Gemini 模型使用 Gemini 原生协议，也就是 /v1beta/models/...。
换句话说，地址只有一个，协议按模型匹配。你不需要为每类模型准备不同的服务地址，也不需要在多个入口之间来回切换。这一点正是 Vana API 在使用时最省事的地方。
§ Codex 从配置到第一次调用
下面是一个明确标注的示例流程，假设你日常使用 Codex 写代码、做重构、整理文档。第一步，在 Vana API 的控制台创建 key。key 只在控制台生成，示例中我们把它当作一把访问凭据使用，不把它写进公开仓库或共享文件。
第二步，充值。Vana API 采用预付余额，按真实 token 计费，没有月费。注册赠送 ¥0.50 的额度，这笔金额可以直接作为第一次试用的起点。如果你只是想确认链路是否通畅，这 ¥0.50 已经足够跑一次很短的对话。
第三步，在 Codex 的配置中填写两项内容：base address 指向 https://api.vanaapi.com，key 填入刚才创建的那一把。然后选择要用的 GPT 模型，让 Codex 发出一次 /v1/responses 请求。整个过程没有额外组件要部署，也没有中间层要维护。
第四步，回到控制台的 usage log 查看这次调用。Vana API 的每一次调用都会记录在用量日志里，包括时间、模型与对应扣费。示例中，如果你发现某个任务消耗得比预期多，可以先在日志里核对，再回到设置更换模型，而不是凭感觉调整。
§ 按量付费与月计划怎么选
如果你原本打算长期保留某个订阅或官方账号，Vana API 提供的是另一种账目方式：预付余额，按真实 token 扣费，没有月费。用量少的月份，账面只按实际消耗走；用量集中时，再考虑月计划。
看一个具体例子。假设某个任务每月输入 1,000,000 tokens、输出 1,000,000 tokens，模型选 GPT-5.6 Sol。Vana API 的价格是输入 ¥2.50、输出 ¥13.00，两者相加是 ¥15.50。同样的数字对照官方标价：输入 ¥28.8、输出 ¥144，相加是 ¥172.8。这只是按单价做的示例计算，实际用量不同，结果也会不同。
再换一个模型看，GPT-6.1 Sol 的 Vana API 价格为输入 ¥1.00、输出 ¥6.00；官方标价是输入 ¥14.4、输出 ¥72。GPT-6 Astra 的 Vana API 价格为输入 ¥5.00、输出 ¥25.50；官方标价是输入 ¥72、输出 ¥360。Codex 的任务类型不同，token 结构也不同，所以对比时应当分别看输入与输出两项，而不是只比一个数字。
如果你的使用节奏相当固定，Vana API 也有月计划可选。例如 GPT 最多 $4,000 / 30 天，价格是 ¥746.00 for 30 days，每周上限 $1,200，仅限 GPT 模型。把这个数字放进上面的示例里对照：如果每月的输入与输出都明显超过示例水平，月计划可能更接近你的实际需要；如果用量忽高忽低，按量付费更容易控制。两者的差别不在于谁更省事，而在于账目方式是否贴合你的节奏。
§ 同一地址上的其他模型
Codex 之外，Vana API 的同一个地址也能承接其他模型，但客户端必须与协议对应。Claude Fable 5.1 的 Vana API 价格是输入 ¥24.00、输出 ¥120.50，官方标价是输入 ¥72、输出 ¥360。Claude Opus 5.5 的 Vana API 价格是输入 ¥10.50、输出 ¥50.00，官方标价是输入 ¥28.8、输出 ¥144。
需要说明的是，Claude 模型只能从官方 Claude Code 或 Claude Desktop 使用，版本需为 2.1.285 或更高，这两个客户端本身就说 Anthropic Messages 协议。它们不适用于其他客户端、SDK、cURL 或脚本。Gemini 模型则只能从 Gemini CLI 使用，走 Gemini 原生协议，并非 OpenAI 兼容格式。Gemini 2.5 Flash 的 Vana API 价格是输入 ¥1.50、输出 ¥11.50；Gemini 3.1 Pro 是输入 ¥10.00、输出 ¥57.00。
其余模型使用 OpenAI 格式，可以从 Cursor、Cline、Roo Code、OpenCode、Cherry Studio、任意 OpenAI SDK 或 cURL 调用。Grok 4.7 是输入 ¥3.50、输出 ¥11.00；DeepSeek V4 Flash 是输入 ¥2.00、输出 ¥7.50；GLM-5.3 是输入 ¥4.00、输出 ¥12.00；Kimi K3 是输入 ¥7.50、输出 ¥37.50。
还有几个价格更低的选项值得记一下：Qwen3.7 Plus 输入 ¥0.92、输出 ¥3.00；MiniMax M3 输入 ¥1.00、输出 ¥4.00；MiMo V2.6 Pro 输入 ¥1.50、输出 ¥2.50；Qwen3.8 Max 输入 ¥5.00、输出 ¥15.00。同一个地址，不同模型，不同价格，选择权仍然在你手里。
§ 充值、退款与推荐收益
账目清楚比省事更重要。Vana API 的每一次调用都出现在控制台的用量日志里，余额按真实 token 扣减，没有月费这种固定支出。充值之后，如果你在 3 天 内提出退款，未使用余额可以退回，扣除已经使用的部分以及支付处理方的手续费。这个规则写在明处，你在决定充值多少之前就能看到。
邀请机制也按同样方式说明：你邀请的人付费后，你获得其付费金额的 14%；再往下一层是 5%。收益满 ¥100.00 后可以提现。推荐本身不会改变你的调用体验，它只是把已经发生的付费关系记录成两级收益。
回到最初的例子：你在 Vana API 控制台创建一把 key，充值 ¥0.50 或更多，在 Codex 里填入 https://api.vanaapi.com，选一个 GPT 模型，发起一次 /v1/responses 请求，然后到用量日志里查看结果。一个地址，三种协议，极少的设置，这就是 Vana API 想提供的全部结构。