Vana 接入 MiniMax M3：按量付费 ¥1.00 教程
§ 五分钟开始：先把地址和账户准备好
使用 Vana API 的整体路径可以概括为一句话：一个地址，三种协议，配置尽量少。API 请求统一发往 https://api.vanaapi.com，这个地址只负责响应 API 请求；密钥、余额和用量日志都在主站 https://vanaapi.com 的控制台里管理。把两处职责分开，思路就清楚了：控制台负责账户与充值，接口地址负责模型调用。
开始前先在控制台创建密钥。注册新账户有 ¥0.50 的赠送额度，足够跑通一次简单请求，不必立刻充值。Vana API 采用预付余额计费，按真实 token 用量扣费，没有月费；控制台的用量日志会逐条列出每次调用，之后核对消耗有据可查。
整个流程按时间排开也简单：注册并领取 ¥0.50 赠送额度，在控制台创建密钥，选择模型与协议，发出一次请求，然后在用量日志里确认这次调用。前后都是控制台里的常规操作，接口地址始终是同一个 https://api.vanaapi.com，不需要为不同模型另找入口。
需要留意的是，https://api.vanaapi.com 不是控制台入口。密钥、余额、日志都在主站完成。把请求发到接口地址，把管理动作留在主站，是使用 Vana API 时先记住的分工。
§ 三种协议：先选对路径，再选模型
同一个 https://api.vanaapi.com 地址下，Vana API 提供三种协议。不同模型家族使用的接入方式并不通用，选对协议往往比选对模型更关键。
- Claude 模型只能通过官方 Claude Code 或 Claude Desktop 接入，版本需为 2.1.285 或更高，这两个客户端自身使用 Anthropic Messages（/v1/messages）。
- 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 使用这一路径。
Claude 模型只走上面那两个官方客户端，版本条件也是固定的；Gemini 模型只走 Gemini CLI 的原生协议。这两条边界是明确的，协议之间不可互相替代，认准之后再动手能省掉排查时间。
本篇要接入的 MiniMax M3 属于 OpenAI 格式这一组，所以它的接入路径最短：准备密钥、填入接口地址、指定模型 id，就能发出请求。
§ MiniMax M3 的价格：按量付费，数字清楚
MiniMax M3 的模型 id 是 MiniMax-M3，在 Vana API 上按每百万 token 计费，输入 ¥1.00，输出 ¥4.00。价格表上的数字就是实际扣费依据，不需要理解复杂档位，也不必为暂时用不到的额度预先付费。
举例说明：假设你每天用 MiniMax M3 处理固定的输入与输出量，若每天输入 100 万 token、输出 10 万 token，按输入 ¥1.00、输出 ¥4.00 计算，每天费用是 ¥100.00 + ¥40.00 = ¥140.00，按 30 天计为 ¥4,200.00。这是示例场景，实际用量不同，花费也不同。
与按月预付的思路不同，按量付费把选择权留在你手里：调用量少时余额消耗自然少，调用量增加时再补充即可。Vana API 的价格表按输入与输出分别列出每百万 token 的费用，比较时只需看这两列数字。
测试阶段可以用赠送的 ¥0.50 验证链路，正式使用再按需要充值。Vana API 的余额和用量日志都在控制台随时可查，每一笔扣费都能对应到具体的一次调用。
§ 充值、退款与推荐：规则同样简单
充值前可以先把规则看清楚。Vana API 预付余额按真实 token 扣费，没有月费；未使用的余额可以在充值后 3 天内申请退款，退款金额会扣除已使用部分和支付处理方的费用。
推荐计划按被邀请人的实际付费结算：你邀请的人付费，你可获得其中 14%；再往下 5% 一层。收益满 ¥100.00 后可以提现。注册时的 ¥0.50 赠送额度与推荐收益都可以在控制台查看。
对刚开始使用 Vana API 的人来说，账户里的每一笔变化都有出处：充值有记录，调用有日志，赠送额度与推荐收益有对应的入口。了解这些之后，剩余精力可以放回模型本身，而不是账单细节。
§ 五分钟接入清单：填三处，跑一次
实际接入 MiniMax M3 时，需要填写的只有三处：接口地址 https://api.vanaapi.com、控制台创建的密钥、模型 id MiniMax-M3。协议选择 OpenAI 格式，请求路径是 /v1/chat/completions。
客户端方面，MiniMax M3 可以直接在 Cursor、Cline、Roo Code、OpenCode、Cherry Studio 中使用，也可以通过任意 OpenAI SDK 或 cURL 发起请求。用 cURL 验证时，把请求地址、密钥和模型 id 填好即可，正常会收到响应。
如果你更习惯在编辑器里工作，MiniMax M3 的 OpenAI 格式与常见客户端的写法一致，配置好地址与密钥后即可开始对话；如果需要脚本化调用，用 cURL 或任意 OpenAI SDK 发送同样的请求。无论哪种方式，Vana API 侧的地址、密钥和模型 id 都不变。
验证成功的判断标准也很直接：控制台用量日志里出现这次调用，余额按实际 token 扣减。到这里，MiniMax M3 已经通过 Vana API 接入完成，后续只是按需要调整客户端里的模型选择。