OpenCode接入Vana API教程,按量付费¥0.92起
§ 先从学生最熟悉的角度说起:只填一个地址
如果你是学生,第一次接触大模型 API,往往会被一堆名词挡住:要找服务地址,要理解不同模型用什么请求格式,还要弄清钱是怎么扣的。Vana API 想让这件事尽量简单:一个地址 https://api.vanaapi.com,三种协议,配置尽量少。你不需要为每类模型换不同的入口,也不需要研究复杂的结算方式。OpenCode 就在这类场景里很合适,因为它使用 OpenAI 格式的接口,指向同一个地址就能开始用。
需要分清的是,https://api.vanaapi.com 这个地址只处理 API 请求。密钥、余额和用量日志都在主站 https://vanaapi.com 的控制台里完成。学生可以先在控制台创建密钥,再把这个地址填进 OpenCode,过程很短。Vana API 采用预付余额,按实际 token 计费,没有月费;每一笔调用都会出现在控制台的使用日志里,花了多少、什么时候花的,都能回看。
对刚入门的人来说,这种结构比“先买套餐再慢慢研究”更直观。你用多少就付多少,没调用就不产生费用。新用户注册还有 ¥0.50 的赠送额度,可以先用它跑通一次完整的请求流程,确认 OpenCode 里的配置没有问题,再决定后续充值多少。
§ OpenCode 与 Vana API 的接法:一个地址,按 OpenAI 格式
OpenCode 属于使用 OpenAI 格式的客户端,因此它对应的接口路径是 /v1/chat/completions,基础地址就是 https://api.vanaapi.com。GPT、Grok、DeepSeek、GLM、Kimi、Qwen、MiniMax、MiMo 这些模型都可以在 OpenCode 中使用,模型 id 直接写在配置里即可。GPT 模型另外还支持 /v1/responses,这条路径是 Codex 使用的。
配置时可以按这样的顺序做:首先在 https://vanaapi.com 的控制台创建一枚密钥;然后把 OpenCode 的服务地址填为 https://api.vanaapi.com;接着选择一个你打算用的模型 id,并填入密钥;最后发出一条普通对话请求,看它是否能正常返回。整个过程没有额外的中间步骤,Vana API 的设置量确实很少。
这里也说明一下“一种地址”的含义。Vana API 在同一个地址上提供三种协议,OpenCode 走的是其中的 OpenAI 格式,因此不需要为它另找入口。协议只是请求格式的区别,地址始终是同一个 https://api.vanaapi.com。对于学生做课程作业、代码练习或者个人小项目来说,记一个地址就够了。
§ 模型怎么选:先看每百万 tokens 的真实价格
选模型时,Vana API 的价格表按每百万 tokens 列出输入与输出两档费用,单位是人民币。GPT-5.6 Sol(模型 id gpt-5.6-sol)的价格是 Vana API ¥2.50 / ¥13.00,官方标价 ¥28.8 / ¥144;GPT-6.1 Sol(模型 id gpt-6.1-sol)是 Vana API ¥1.00 / ¥6.00,官方标价 ¥14.4 / ¥72。GPT-6 Astra(模型 id gpt-6-astra)则是 Vana API ¥5.00 / ¥25.50,官方标价 ¥72 / ¥360。
其他可选模型的价格同样清楚。DeepSeek V4 Flash(模型 id deepseek-v4-flash)为 ¥2.00 / ¥7.50,DeepSeek V4 Pro(模型 id deepseek-v4-pro)为 ¥8.00 / ¥24.00;Qwen3.7 Plus(模型 id qwen3.7-plus)为 ¥0.92 / ¥3.00,Qwen3.8 Max(模型 id qwen3.8-max)为 ¥5.00 / ¥15.00;GLM-5.3(模型 id glm-5.3)为 ¥4.00 / ¥12.00。
还有几个价格也一并列出,方便对照:Grok 4.7(模型 id grok-4.7)为 ¥3.50 / ¥11.00,Kimi K3(模型 id kimi-k3)为 ¥7.50 / ¥37.50,MiMo V2.6 Pro(模型 id MiMo-V2.6-Pro)为 ¥1.50 / ¥2.50,MiniMax M3(模型 id MiniMax-M3)为 ¥1.00 / ¥4.00。Vana API 的计费口径是按真实 token 计算,所以输入多还是输出多,会直接影响你的实际支出。
§ 按量付费怎么落地:余额、日志与退款
假设你每天用 OpenCode 写一段练习代码,那么在 Vana API 上看到的会是预付余额逐步减少,而不是一个自动延期的月费数字。每笔调用都记在控制台的使用日志里,你可以按时间查看调用记录,对照价格表估算消耗。预付余额的好处是可控:花完就停,续充再看。
充值后的规则也写得明白。未使用的余额可以在充值后 3 天内申请退款,退款金额会扣除已经使用的部分以及支付处理方的手续费。也就是说,前几天如果发现用量不合预期,还有调整空间。
邀请机制可以顺便了解一下。你邀请的人消费后,你获得他们支付金额的 14%;再往下一层的邀请,获得 5%。收益从 ¥100.00 起可以提现。这不是买套餐,而是把已经发生的按量付费分享出去,Vana API 的结算方式始终围绕真实用量展开。
§ 如果用量稳定:GPT 的 30 天方案
对用量比较稳定、并且主要使用 GPT 模型的学生,Vana API 还提供月度方案:GPT 最多 $2,750 / 30 天,价格为 ¥746.00 for 30 days,每周最多 $820,只覆盖 GPT models。这一条适合能预估自己调用量、并且希望在 30 天内不必反复小额充值的情况;如果你的使用还很零散,预付余额按量付费通常更贴合实际。
两种方式可以对照着看:按量付费跟着 token 走,日志里逐笔可见;30 天方案给出的是 GPT models 的固定额度与周期限制。Vana API 把选择权留在你手里,而无论选哪一种,地址始终是 https://api.vanaapi.com,OpenCode 的配置也保持同样的一步。
§ 把 OpenCode 跑起来,实际只需要几件事
回到最实际的问题:学生用 OpenCode 到底要做什么?答案可以很短——到 https://vanaapi.com 创建密钥,在 OpenCode 里填入 https://api.vanaapi.com,选一个价格你能接受的模型 id,比如 Qwen3.7 Plus 的 ¥0.92 / ¥3.00,或者 GPT-6.1 Sol 的 ¥1.00 / ¥6.00,然后发出一条请求。剩下的就是看控制台的使用日志,按真实 token 的消耗决定要不要继续充值。
这就是 Vana API 目前的形态:一个地址,三种协议,尽量少的设置,按真实 token 计费,没有月费。OpenCode 负责你的界面和交互,Vana API 负责把请求送到对应的模型并记录用量。两边各司其职,学生不必先理解全部协议细节,就能把注意力放回代码本身。