VanaAPI
登录

← 文章

Cursor 接入教程：Vana API 一址三协议，¥0.50

终端里的 AgentZH2026-11-06

§ 一个地址，三种协议

把 Vana API 当成一个统一入口来理解，配置工作会简单很多。所有模型请求都发往同一个地址：https://api.vanaapi.com。这个地址只负责回答 API 请求，不承担控制台功能；密钥、余额和使用日志都在主站 https://vanaapi.com 的 dashboard 里管理。地址与后台分开，是一件很清爽的事：填地址时不会犹豫，查账时也不会跑错地方。

同一个地址背后对应三种协议：/v1/messages、/v1beta/models/... 与 /v1/chat/completions。协议不同，适合的客户端也不同，这一点在动手前看清楚，可以省掉后面反复排查的时间。Vana API 的思路是让你只记住一个地址，其余按模型所属的协议去匹配客户端。

对于本文要讲的 Cursor，它走的是 OpenAI 格式，也就是 /v1/chat/completions。Windows、macOS 与 Linux 上的 Cursor 用法一致：地址填 https://api.vanaapi.com，密钥在 dashboard 创建后填入，然后选择模型、发送请求。跨平台意味着换机器不用重新学一遍流程，换系统也只是复制同一个地址和同一把密钥。

§ Cursor 的接入步骤

下面这份清单按顺序做一次即可，每一步都对应 Vana API 明确提供的东西，不涉及额外的中间环节。

  • 打开 https://vanaapi.com 的 dashboard，在里面创建一枚 API 密钥。
  • 把接口地址设置为 https://api.vanaapi.com，注意结尾不带斜杠，也不要换成主站地址。
  • 在 Cursor 的接口配置中填入这枚密钥，Windows、macOS、Linux 都用同一套地址与密钥。
  • 选择需要的模型 id，例如 gpt-5.6-sol、deepseek-v4-pro 或 qwen3.8-max，然后发送一条测试请求。
  • 回到 dashboard 的 usage log 查看这条调用，确认它已经被记录。

清单到这里就结束了。整个过程只有「建密钥、填地址、选模型」三件实际动作，Vana API 没有额外的注册层级或配置页面需要逐个走完。想在多台设备上使用 Cursor 时，同一把密钥与同一个地址直接复用即可。

需要留意的一点是，Cursor 只能使用 OpenAI 格式这一类模型，包括 GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax 与 MiMo。带独立协议的模型不在这条路径上，混用之前先确认模型 id 属于哪一类。

§ 三种协议与对应客户端

OpenAI 格式（/v1/chat/completions）这一类模型，可以从 Cursor、Cline、Roo Code、OpenCode、Cherry Studio、任意 OpenAI SDK 或 cURL 调用。也就是说，Cursor 只是这条路径上的一个客户端，脚本和 SDK 同样可以指向 https://api.vanaapi.com。

GPT 模型同时也在 /v1/responses 上应答，Codex 使用的正是这个路径。同一批 GPT 模型因此可以覆盖 Cursor 与 Codex 两种使用习惯，而地址始终是同一个。

另有一类模型只能由官方 Claude Code 或 Claude Desktop 使用，要求版本 2.1.285 或更高，它们自身直接讲 Anthropic Messages（/v1/messages），不经过任何其他客户端、SDK、cURL 或脚本。

还有一类模型只能由 Gemini CLI 使用，走 Gemini 原生协议（/v1beta/models/...），并不是 OpenAI 兼容格式。把这条规则记住，再看 Cursor 里的模型列表就会清楚很多：哪些模型可调、哪些要走别的客户端，一眼就能分开。

§ Cursor 可用模型与价格

下面是价格表中的模型，全部属于 Cursor 可以直接调用的 OpenAI 格式。价格单位为每百万 token，按输入 / 输出列出，数值照实写明，不做换算。

  • GPT-5.6 Sol（model id gpt-5.6-sol）：Vana API ¥2.50 / ¥13.00，官方标价 ¥28.8 / ¥144。
  • GPT-6 Astra（model id gpt-6-astra）：Vana API ¥5.00 / ¥25.50，官方标价 ¥72 / ¥360。
  • GPT-6.1 Sol（model id gpt-6.1-sol）：Vana API ¥1.00 / ¥6.00，官方标价 ¥14.4 / ¥72。
  • Grok 4.7（model id grok-4.7）：Vana API ¥3.50 / ¥11.00。
  • DeepSeek V4 Flash（model id deepseek-v4-flash）：Vana API ¥2.00 / ¥7.50。
  • DeepSeek V4 Pro（model id deepseek-v4-pro）：Vana API ¥8.00 / ¥24.00。
  • GLM-5.3（model id glm-5.3）：Vana API ¥4.00 / ¥12.00。
  • Kimi K3（model id kimi-k3）：Vana API ¥7.50 / ¥37.50。
  • Qwen3.7 Plus（model id qwen3.7-plus）：Vana API ¥0.92 / ¥3.00。
  • Qwen3.8 Max（model id qwen3.8-max）：Vana API ¥5.00 / ¥15.00。
  • MiniMax M3（model id MiniMax-M3）：Vana API ¥1.00 / ¥4.00。
  • MiMo V2.6 Pro（model id MiMo-V2.6-Pro）：Vana API ¥1.50 / ¥2.50。

拿 GPT-5.6 Sol 做个对照，输入价是 ¥2.50 对官方标价 ¥28.8，输出价是 ¥13.00 对 ¥144。这组数字来自上面的价格表本身，用它来估算自己的用量，比凭感觉估更靠得住。

§ 按量付费、充值与账单

Vana API 采用预付余额的方式，按真实 token 计费，没有月费。注册即赠 ¥0.50 额度，可以先用来跑通一次 Cursor 请求，确认地址与密钥无误。每一次调用都会出现在 dashboard 的 usage log 里，调用了哪些模型、消耗了多少 token，逐条可查。

推荐奖励按两级计算：你邀请的人付费，你获得其中 14%；再往下的一层，获得 5%。收益满 ¥100.00 即可提现。充值后 3 天内，未使用的余额可以退款，退款金额会扣除已经使用的部分与支付手续费。

如果你更希望按周期付费，Vana API 提供「GPT 最多 $2,750 / 30 天」计划：¥746.00 / 30 天，每周上限 $820，仅限 GPT 模型。这个计划适合用量稳定、且希望在 Cursor 里固定使用 GPT 的场景；用量波动较大时，按量付费的预付余额方式更贴合实际消耗。

§ 把配置一次做对

回到那份清单：地址 https://api.vanaapi.com，密钥在 dashboard 创建，模型从上面这份 OpenAI 格式列表里选，调用记录在 usage log 里核对。Windows、macOS、Linux 共用同一套配置，Vana API 的三种协议各自对应清楚的客户端路径，认准自己所用模型的那一条即可。

先完成一次注册与一次测试调用，再决定后续的充值额度或月度计划，整个过程都不需要额外的工具或绕行的步骤。地址始终只有一个，账目始终在同一处，剩下就是把模型选对。

再读一篇