VanaAPI

← 文章

Roo Code 接入 Vana:按量付费 ¥0.92 教程

日常活儿ZH2026-11-05

§ 从一个地址开始:Roo Code 接入 Vana API

如果你准备在 Roo Code 中使用模型,Vana API 的设置思路可以概括为:一个地址,三种协议,尽量少的配置。Roo Code 属于支持 OpenAI 格式的客户端,因此接入时使用 Vana API 的 https://api.vanaapi.com,并选择 OpenAI 格式的接口路径 /v1/chat/completions。这个地址只负责回答 API 请求,密钥、余额和使用日志都在 Vana API 主站 https://vanaapi.com 管理。

开始前需要准备两样东西:一个 Roo Code 环境,以及在 Vana API 仪表盘创建的密钥。密钥不是在客户端里生成的,余额和使用记录也不是在 Roo Code 里查看。把这两部分分开,排查问题时通常会更清楚。注册 Vana API 后可以领取 ¥0.50 的赠送额度,先用它完成一次实际请求,再决定后续充值多少。

下面按一次性检查清单的顺序,完成 Roo Code 的接入。整个过程不需要把多个服务商地址放在一起比较,也不需要为不同模型反复搭建客户端。Vana API 的核心是让同一个入口对应不同协议,Roo Code 则对应其中的 OpenAI 格式。

§ 确认协议和模型:Roo Code 使用 OpenAI 格式

Roo Code 可以通过 OpenAI 格式调用 Vana API 上列出的 GPT、DeepSeek、GLM、Kimi、Qwen、MiniMax 和 MiMo 模型。对应的请求路径是 /v1/chat/completions,这类客户端也可以使用任何 OpenAI SDK 或 cURL。GPT 模型另外支持 /v1/responses,这是 Codex 使用的路径;在 Roo Code 中按 OpenAI 格式配置即可。

模型选择时,可以先看 Vana API 的价格表。下面这些模型都属于 Roo Code 可用的 OpenAI 格式范围,价格按每百万 tokens 的输入和输出分别列出:

  • GPT-5.6 Sol,模型 id 为 gpt-5.6-sol,Vana API 输入 ¥2.50、输出 ¥13.00。
  • GPT-6 Astra,模型 id 为 gpt-6-astra,Vana API 输入 ¥5.00、输出 ¥25.50。
  • GPT-6.1 Sol,模型 id 为 gpt-6.1-sol,Vana API 输入 ¥1.00、输出 ¥6.00。
  • DeepSeek V4 Flash,模型 id 为 deepseek-v4-flash,Vana API 输入 ¥2.00、输出 ¥7.50。
  • DeepSeek V4 Pro,模型 id 为 deepseek-v4-pro,Vana API 输入 ¥8.00、输出 ¥24.00。
  • GLM-5.3,模型 id 为 glm-5.3,Vana API 输入 ¥4.00、输出 ¥12.00。
  • Kimi K3,模型 id 为 kimi-k3,Vana API 输入 ¥7.50、输出 ¥37.50。
  • Qwen3.7 Plus,模型 id 为 qwen3.7-plus,Vana API 输入 ¥0.92、输出 ¥3.00。
  • Qwen3.8 Max,模型 id 为 qwen3.8-max,Vana API 输入 ¥5.00、输出 ¥15.00。
  • MiniMax M3,模型 id 为 MiniMax-M3,Vana API 输入 ¥1.00、输出 ¥4.00。
  • MiMo V2.6 Pro,模型 id 为 MiMo-V2.6-Pro,Vana API 输入 ¥1.50、输出 ¥2.50。

例如,你想先试用一个输入价格较低的模型,可以从 Qwen3.7 Plus 的 ¥0.92 开始;如果你更熟悉 GPT 系列,则可以使用 GPT-6.1 Sol 的 ¥1.00 输入价格。模型名称和模型 id 要按价格表填写,名称用于阅读,id 用于实际请求。

§ 在仪表盘创建密钥并完成充值

打开 Vana API 主站 https://vanaapi.com,进入仪表盘后创建 API key。创建完成后,把密钥复制到 Roo Code 的 API 配置中。密钥只在仪表盘生成和管理,Roo Code 负责发送请求,主站负责展示余额与使用日志,这个分工适合按步骤检查。

Vana API 采用预付余额方式计费,按真实 token 收费,没有月费。充值前可以先确认当前余额和待使用的模型,再决定金额。使用记录会逐次出现在仪表盘的使用日志中,因此一次请求是否成功、消耗了多少 token,都可以在 Vana API 端核对,而不必依赖客户端的估算。

如果你需要长期、稳定的用量安排,也可以查看 Vana API 的月度方案:GPT 最多 $2,750 / 30 天,价格为 ¥746.00 for 30 days,每周最多 $820,并且只适用于 GPT models。没有月度计划时,直接充值余额、按量付费即可;两种方式都不需要改变 Roo Code 的接入地址。

§ 填写 Roo Code 配置:只改必要的字段

在 Roo Code 中选择 OpenAI 兼容方式,API 地址填写 https://api.vanaapi.com,API 路径使用 /v1/chat/completions,然后粘贴刚才在 Vana API 仪表盘创建的密钥。模型栏填写你选择的 model id,例如 gpt-6.1-sol、deepseek-v4-flash 或 qwen3.7-plus。

保存后发送一条简短消息,作为连通性检查。若 Roo Code 报错,先确认地址是否写成了主站地址,再确认路径是否误填成其他协议路径,最后确认模型 id 是否来自 Vana API 的价格表。Vana API 的 API 地址和仪表盘地址用途不同:请求发往 https://api.vanaapi.com,密钥与余额在 https://vanaapi.com 查看。

这个检查步骤也适用于其他支持 OpenAI 格式的客户端,例如 Cursor、Cline、OpenCode、Cherry Studio、任何 OpenAI SDK 或 cURL。Roo Code 的配置重点仍然是同一件事:使用 Vana API 的一个地址,选择 OpenAI 格式,并填入对应模型 id。

§ 核对用量、充值和退款边界

完成测试后,回到 Vana API 仪表盘查看使用日志。每一次调用都会列在日志里,输入和输出 token 对应的费用可以逐条核对。Vana API 按真实 token 计费,没有月费,因此日常使用时可以先根据实际日志判断速度,再逐步调整模型,而不是预先承诺一个固定用量。

退款规则也写得很具体:充值后 3 天 内,未使用余额可以退款,扣除已经使用的部分以及支付处理机构的费用。也就是说,充值后尽早检查 Roo Code 的请求是否正常,能让余额安排更简单。注册赠送的 ¥0.50 适合先做连通性测试,测试完成后再决定是否继续充值。

如果你邀请别人使用 Vana API,邀请的人实际支付金额的 14% 归你,距离更远一层的 5% 也归你;收益达到 ¥100.00 后可以提现。这个机制适合持续使用并自然邀请他人的用户,但不应替代对模型输出质量的判断。

§ 最后确认:一次接入,之后按日志管理

Roo Code 接入 Vana API 的清单可以压缩为四步:在主站创建密钥,在同一个 API 地址下选择 OpenAI 格式,填写价格表中的模型 id,最后用一条消息测试并查看使用日志。一个地址、三种协议、少量设置,这就是 Vana API 适合 Roo Code 接入的原因。

模型价格可以直接对照上面的数字选择。例如,Qwen3.7 Plus 的输入价格为 ¥0.92,GPT-6.1 Sol 的输入价格为 ¥1.00;输出价格则分别是 ¥3.00 和 ¥6.00。这些是每百万 tokens 的价格,实际费用由真实输入和输出 token 决定。Vana API 仪表盘会保留每次调用记录,后续充值、核对和调整都可以围绕这些记录进行。