MiniMax 的 Token Plan 已经成为历史，控制台入口换成了全新的 M Plan。全模态额度大一统、H3 视频解禁，再加上 Claude Code 与 Cursor 的免密接入，这轮变化的含金量比表面看起来要高得多。如果你手头还有旧版脚本在按 Token Plan 的逻辑跑，建议先别急着写新功能，把额度模型和接入方式理清楚再动手。这篇文章会把新旧套餐到底差在哪、H3 视频解禁后实际怎么用、以及我验证过的一套在 Claude Code 和 Cursor 里免密调用 MiniMax 模型的完整流程一次讲透。适合正在做多模态应用、AI 编码工具链，或者想把文本、图像、视频统一到一个额度池里管理的开发者。
1. Token Plan 退场：旧的额度体系到底别扭在哪
1.1 多模态额度被拆得七零八落
以前用 Token Plan 的时候，最头疼的不是模型效果，而是“看额度余额”。文本、语音、图像、视频各自有独立的额度统计，打开控制台要翻好几个页面才能搞清楚还剩多少。我见过很多团队做多模态应用，最后都卡在同一件事上：文本额度还剩一大截，视频额度却已经见底，不得不临时去充值，而充进去的文本额度又用不完，下个月清零，钱白花了。
这种分散计费带来的问题还不止是浪费。当你想估算一个项目一个月到底要花多少钱时，得把四种模态的消耗曲线分别预估，再叠加每个模型的单价、上下文长度、输出长度，算到一半基本就放弃了。最后大家只能拍脑袋定预算，然后月底对账单时一脸懵。
1.2 新模型上线总要“等一等”
旧方案下，一款新模型发布后，往往不是所有用户立刻就能用。有的要先申请、有的在灰度名单里、还有的只在特定套餐开放。H3 视频模型之前就是这么个状态：看演示效果很不错，但想在自己项目里调用，先得填申请，等审核，通过之后还要看套餐里有没有对应权限。对于想快速验证创意的开发者来说，这中间的等待成本非常劝退。
所以这次“H3 视频解禁”之所以被反复提起，本质上是流程变了：从“申请-审核-开通”变成了“套餐内直接可调”。对开发者的意义是，视频生成终于可以像文本对话一样，当成一个普普通通的 API 来接进自己的工作流里。
1.3 超支风险与碎片化管理并存
旧方案还有一个让人头疼的地方：每种模态的扣费逻辑都不一样。文本按 token 算，语音要考虑时长，图像按张数，视频又按分辨率、帧率、时长、生成次数叠加。想在代码里做用量统计，得写好几种换算逻辑，稍微错一个系数，账单就差出一大截。
另外，多个额度池并存时，运营动作也容易出问题。你想在活动期间给用户增加一点视频额度，却发现调整入口在另一个套餐里，改完还要担心会不会影响文本额度的扣减。这种碎片化管理，对大团队来说是内耗，对个人开发者来说是干扰。
1.4 Token Plan 与 M Plan 的直观差异
| 对比项 | Token Plan（旧） | M Plan（新） |
|---|---|---|
| 额度范围 | 文本、语音、图像、视频分开统计 | 全模态统一为一个额度池 |
| 视频模型 | H3 等模型常需单独申请/灰度 | 已在套餐内解禁，可直接调用 |
| 新模型接入 | 可能要等额外开通 | 更倾向于开箱即用 |
| 计费逻辑 | 每种模态单独折算 | 统一折算单位，看一个余额 |
| 管理复杂度 | 多入口、多套餐、多余额 | 单一入口，一个数字 |
| 开发者关注点 | 每一类任务的精确单价 | 总消耗节奏和额度预算 |
这张表不是官方参数表，是我自己从开发者视角做的对比。具体扣费系数、模型清单，还是要以控制台的实际显示为准。但大方向很清楚：MiniMax 想把“额度管理”这件事从多个独立账本，收敛到一份总账。
2. 接入前想清楚：Claude Code 与 Cursor 的角色定位和免密逻辑
2.1 终端里的 Claude Code 和编辑器里的 Cursor
很多刚接触 AI 编程工具的朋友会把 Claude Code 和 Cursor 当成同一种东西，其实两者体验差别挺大。
Claude Code 更像是“驻留在终端里的开发代理”。它读你的项目结构、跑命令、改代码，交互方式以命令行为主。好处是自动化程度高，适合脚本化调用、批量重构、CI 流程里跑任务。坏处是有一定上手门槛，不熟悉终端操作的人会觉得它不够直观。
Cursor 则是把 AI 能力直接塞进了编辑器。补全、对话、跨文件修改都在图形界面里完成，鼠标点一点就能看到 diff，对前端设计、日常写业务代码的人来说非常顺手。它更像“一个带 AI 助手的开发环境”，而不是“一个跑在终端的代理”。
这两个工具不是替代关系，更像一个组合：Cursor 负责日常开发和重度交互，Claude Code 负责批处理、自动化、以及需要全仓上下文的高强度重构。我现在的习惯是，灵光一闪时先在 Cursor 里快速验证想法，验证通过后再把稳定步骤写成脚本，交给 Claude Code 在终端里批量跑。
2.2 为什么要让 M Plan 接入这两款工具
最大的理由当然是“不想开着一堆订阅却用不满”。如果你已经在用 MiniMax 的 M Plan 做多模态应用，文本对话、语音合成、图像理解、视频生成都从同一个额度池里扣，那么写代码时也希望复用这套额度，而不是再单独给编程工具买一份别家的套餐。
其次是流程联动。比如我要做一个视频素材批量生成工具，之前的流程是：写完脚本，切到某个平台网页，手动上传提示词，下载结果，再回到本地拼进项目。接入之后，直接在 Claude Code 里调接口，把生成结果落地到本地目录，再把 Cursor 打开，让 AI 基于这批素材继续改代码。整个链路从“人肉搬运”变成了“自动流转”。
另外，多模态能力在编码场景里也有实用价值。比如用图像理解模型做 UI 走查、用视频模型生成产品演示片段、用语音模型朗读注释。这些东西如果分散在几个平台，项目配置会非常凌乱；统一进 M Plan，项目里只需要维护一份凭证。
2.3 “免密”免的到底是什么
这里要先澄清一个常见的误解：免密不是免费，也不是绕过身份验证。它指的是“一次配置、全局生效”的调用体验。
以前你在每个工具里接入 AI 服务，基本都要手动粘贴 API Key，换台机器再粘一次，配置互相独立，时间一长根本分不清谁在用哪把钥匙。而 M Plan 的思路是把凭证统一到一个接入体系里，只要在环境变量或配置文件里设置一次，Claude Code 和 Cursor 启动时就会自动读取，不需要每次打开工具都重复输入密钥。
这样做还有一个附带好处：密钥不必散落在各个工具的界面上，可以集中管理，方便后续轮换和回收。比如怀疑某把钥匙泄露了，只需要在控制台吊销，再重新生成一把，更新一处环境变量，两个工具就都恢复可用了。
3. Claude Code 实操：环境变量一次配好，终端免密调用
3.1 先获取 API 接入信息
打开 MiniMax 控制台，进入 M Plan 对应的 API 管理页面，创建一把新的 API Key。这里建议你单独生成一把专门给 Claude Code 用的钥匙，不要直接复用网页端或者移动端正在用的主密钥。
原因很简单：Claude Code 跑的脚本经常涉及批量操作，一旦代码里出现异常循环，消耗速度会非常快。单独用一把 Key，方便你在控制台单独看它的用量，也能随时吊销而不影响其他业务。
另外把接入端点地址复制下来。不同区域、不同网络环境可能有不同的接入域名，以你控制台里显示的那个为准。下面代码块里的所有地址都是占位示例，千万别直接照抄。
3.2 用环境变量完成免密配置
Claude Code 的接入方式里，最省事的做法就是配置两个环境变量：一个指向 API 端点，一个填密钥。终端里执行：
export ANTHROPIC_BASE_URL="https://api.example.com/v1" export ANTHROPIC_AUTH_TOKEN="你的M-PLAN密钥"这两个变量名是 Claude Code 常见版本里原生的端点变量和令牌变量，具体名称以你安装版本的最新文档为准。设置完成后，直接运行：
claude -p "打个招呼，顺便告诉我你现在读到的模型配置"如果返回正常回答，说明终端已经成功调到 M Plan。这里不会弹网页验证，也不会要求你手动登录，因为环境变量已经把身份信息带过去了，这就是“免密”的实际体验。
3.3 把配置写进 Shell 启动文件，免去每次 export
上面那种临时 export 的方式，关掉终端再开就失效了，每次都手敲一遍毫无意义。想让 Claude Code 真正做到开箱即用，把两行配置写进 Shell 的启动文件里。
echo 'export ANTHROPIC_BASE_URL="https://api.example.com/v1"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN="你的M-PLAN密钥"' >> ~/.zshrc source ~/.zshrc如果你用的是 Bash，把~/.zshrc换成~/.bashrc或~/.bash_profile。配置好之后，再开新终端窗口，直接运行claude就能识别到环境变量，不用重新设置。
我更推荐的做法是维护项目级的.env文件，配合自动加载工具使用。这样不同项目可以用不同的 Key，也能避免同一个密钥在所有终端里反复暴露。
3.4 首次验证和常见报错
首次跑通之后，建议主动制造几个小问题，提前摸清工具的报错习惯。我自己遇到过三种情况：
- 返回 401 或 403，基本是密钥不对，或者密钥被吊销了，去控制台重新生成一把。
- 返回 404，通常是端点地址不对，或者填写的模型 ID 在当前 M Plan 里不存在。去控制台模型列表确认一下当前可用的模型标识。
- 命令卡在登录验证流程里，不直接走环境变量。这多半是版本行为差异，检查是否开启了强制交互登录，或者环境变量名在当前版本里不支持。
真实项目里遇到最多的不是网络问题，而是配置覆盖问题。比如你同时设置了全局环境变量和项目变量，后者优先级更高，就会导致“明明全局配置了，项目里却报没有密钥”。排查时先看项目目录下有没有.env文件，再查全局配置，按这个顺序处理基本都能定位。
4. Cursor 实操：图形界面挂载 M Plan，模型列表自定义
4.1 在 Cursor 设置里打开自定义模型入口
Cursor 的接入方式和 Claude Code 不一样，它更依赖图形界面。打开设置，找到 Models 或模型管理相关的入口，通常在 Settings 里有一个专门管理 AI 模型的页面。
不同版本的 Cursor 界面命名有一些差异，有些叫模型的英文配置项，有些直接显示为“自定义模型”。如果你找不到类似入口，先检查两件事：一是版本是否太老，二是账号类型是否被限制了自定义模型功能。有些团队版账号由管理员统一控制，普通成员看不到自定义入口，需要联系管理员开放。
4.2 填写端点、密钥和模型标识
在自定义模型区域新建一项，需要填三类信息：
| 字段 | 填写内容 | 注意事项 |
|---|---|---|
| Base URL | 你的 M Plan 接入端点 | 以控制台显示为准，结尾通常带 v1 路径 |
| API Key | 给 Cursor 单独生成的密钥 | 不要和 Claude Code 共用一把 |
| 模型 ID | M Plan 里可用的对话模型标识 | 在控制台模型列表查询，别自己瞎编 |
这三项里最容易填错的是模型 ID。有些朋友照着文档示例随便填一个，结果请求直接 404。正确做法是把控制台模型列表里显示的标识原样粘贴，不要加多余的前后缀，也不要自作聪明改成别名。
填完之后保存，然后在模型下拉框里找到刚才添加的模型，选中它，开始一个新的对话。
4.3 测试真正调通
新建对话后，输入一句能确认身份的提示词，比如“请告诉我你当前使用的模型标识和接入方式”。如果模型能够回答，而且控制台里的用量记录出现了新的调用，说明已经真正调通。
这里有个很容易忽略的点：Cursor 可能会同时保留多个模型供应商的配置。如果你之前已经配置了另一个服务，现在又加了 M Plan，要留意当前对话到底用的是哪个模型。界面右下角或顶部的模型选择器会显示当前模型，别到时候以为是 M Plan 在干活，实际跑的还是老配置。
4.4 与 Claude Code 并行使用的环境隔离建议
如果你和我一样，Claude Code 和 Cursor 都要接 M Plan，建议给两个工具分别准备密钥，不要共用一把。原因很现实：Cursor 的补全请求频率非常高，正常写代码时可能一分钟内发几十个请求；Claude Code 跑批量任务时也可能短时间猛冲。两把密钥分开，你能在控制台里清楚地看到每个工具各自的消耗模式。
环境变量层面也要注意隔离。Claude Code 读的是终端环境变量，Cursor 读的是它自己保存的配置，两者不冲突。但如果你在终端里启动 Cursor 时继承了终端环境变量，那部分变量也可能影响 Cursor 的行为。稳妥的办法是：Cursor 里的 API Key 和 Base URL 只在 Cursor 界面里配置，不让终端环境变量参与，减少意外干扰。
5. H3 视频解禁与统一额度池：工作流编排和消耗控制
5.1 H3 解禁，到底解锁了什么
H3 是 MiniMax 的视频生成模型，这次在 M Plan 里解禁，意味着开发者不再需要单独申请开通，只要套餐额度足够，就能直接调用视频生成能力。
这件事对做内容工具的人影响很大。以前想在应用里做“文字描述生成视频素材”的功能，要先接一个视频模型，再额外处理申请流程、审核状态、用户权限，光接口联调就要折腾很久。现在解禁之后，申请环节消失，视频生成变成了像文本接口一样普普通通的调用，你的产品就可以把视频生成作为一个常规功能开放给终端用户。
5.2 一套可复用的多模态工作流
我现在验证过的流程大概是这样的：
- 在 Cursor 里写生成脚本，脚本负责构造提示词、读取素材目录、配置输出格式。
- 脚本调用 M Plan 的视频接口提交任务，拿到任务 ID 后进入轮询状态。
- 生成完成后，把视频文件保存到项目目录，同时生成一个供网页端预览的缩略图。
- 打开 Claude Code，让 AI 分析这批生成结果，调整下一批的提示词策略。
这套流程的好处是，所有环节都能用代码控制，不会出现“某个视频还要去网页上手动下载”的断档。配合统一额度池，你只需要盯一个余额，不用分别充值视频专用额度和文本额度。
5.3 统一额度池的消耗节奏
统一额度池听起来很省心，但它也有一个副作用：视频生成会直接消耗文本对话可用的额度。一个短视频任务的消耗量，可能顶得上几百轮普通对话。如果你没有做任何限制，一个不小心跑了几条高清视频，一天的量就烧掉一大半。
所以不要把统一额度池理解成“更耐用了”，要理解成“总预算更明确、但消耗大户也更明显了”。视频仍然是整个池子里最吃量的大头，你得在任务开始前想清楚每个视频的必要性。
5.4 我的两套实用建议
第一，批量生成前先做小尺寸预览。不要一上来就生成最终版，先用低分辨率、短时长试跑一批，确认提示词和画面风格都对，再跑正式版本。预览阶段的成功率大概率比想象中低，这一步能帮你省下大量额度。
第二，给视频任务单独设配额。M Plan 是一个总池，但你的业务系统里可以自己再加一层逻辑：比如对每个用户每天只能触发三次视频生成，超出后走排队或降级。这样就算脚本出现死循环，最多只烧掉三次的量，不会直接清空账户余额。
6. 迁移期避坑：从 Token Plan 到 M Plan 最容易踩的五个坑
6.1 旧脚本里的套餐标识和模型名要全面替换
从 Token Plan 迁到 M Plan，不是控制台里换个套餐名字那么简单。代码里所有指向旧套餐、旧额度标识、旧模型名称的地方都要跟着更新。我自己就吃过一次亏，改完了入口参数，漏了日志上报里的套餐标识，结果线上统计全部错乱，排查了半天。
最稳的做法是迁完后跑一遍全链路冒烟测试：文本、语音、图像、视频各造一个最小请求，确认所有接口都返回正常，再放量切换。
6.2 千万别把密钥提交进 Git 仓库
迁移期代码改动多，很多人急着把脚本调通，顺手就把密钥写进了代码文件，最后一起提交进 Git。哪怕仓库是私有的，这种习惯也非常危险，因为历史记录里的密钥不会因为你删掉当前文件就消失。
建议在项目根目录加上.gitignore，把.env、密钥文件、配置文件全部排除掉。如果已经提交过，去密钥管理界面吊销旧密钥，重新生成一把，再清理历史记录。
6.3 “大一统”不等于所有模型都自动开放
全模态额度大一统，指的是扣费口径统一，不代表平台里所有模型都会无条件出现在你的套餐里。有的新模型可能还在灰度测试，有的功能可能要额外满足条件。你在控制台看到的模型列表才是最终真相。
所以在 Claude Code 或 Cursor 里配置模型 ID 之前，先确认两个信息：这个模型在控制台是否显示可用，以及它是否支持当前接入方式的协议。不满足条件时，配置了也调不通，回头还要怀疑是密钥问题，白白浪费排查时间。
6.4 免密配置冲突：多个服务商变量互相覆盖
当你的机器上同时配置了好几个 AI 服务的环境变量时，最容易出现变量名冲突。比如某些工具也会读取同一个环境变量来做端点设定，两个工具一前一后写入配置，后写的就把先写的覆盖了。
我的经验是：能放在工具自身配置文件里的，就别放到全局环境变量里；必须在环境变量里设置的，加上项目级隔离。把每一个工具的配置锁定在最小生效范围内，才不会出现“给 A 工具改配置，结果 B 工具也变样”的诡异问题。
6.5 额度告警一定要提前设置
统一额度池让你只看一个数字，但这个数字下降的速度可能比你想象得快。尤其是视频生成，一个失败的重试流程可能在短时间内反复发起多次请求，等你去控制台看时，额度已经少了一截。
建议在控制台开启用量提醒，额度低于某个百分比就通知你。同时在自己脚本里也加一层计数：每次调用前先查剩余额度，低于阈值直接熔断，不再发起新的生成任务。宁可让任务失败，也别让账户余额归零后才发现。
最后再分享一点个人体会。我自己的习惯是，把文本对话和视频生成拆成两套完全独立的工作流来编排。M Plan 最让我满意的地方，不是某一个模型突然变得多强，而是我终于不需要同时盯四五个余额了。刚迁过来的朋友，建议先花十分钟把旧脚本里的套餐标识全部清一遍，再跑一个最小额度的验证任务，确认扣费逻辑和预期一致后再上大任务。控制台里显示的可用模型和余额，永远是你判断一切配置正确与否的最终依据。
