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_URLhttps://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_URLhttps://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 共用一把模型 IDM 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 最让我满意的地方不是某一个模型突然变得多强而是我终于不需要同时盯四五个余额了。刚迁过来的朋友建议先花十分钟把旧脚本里的套餐标识全部清一遍再跑一个最小额度的验证任务确认扣费逻辑和预期一致后再上大任务。控制台里显示的可用模型和余额永远是你判断一切配置正确与否的最终依据。