1. 从 Token Plan 到 M Plan这次改动到底动了谁的蛋糕MiniMax 把 Token Plan 送进历史博物馆这件事在圈子里其实不算突然。过去大半年只要你同时用文本、语音、视频三条线做产品就一定被额度体系折磨过——文本额度月底清零、语音额度按秒计费、视频额度单独充值三套账单三套限流财务对账的时候能把人逼疯。M Plan 的出现本质上是把这堆散装额度揉成了一个池子全模态共享按实际消耗折算。听起来只是计费方式的调整但对真正在跑生产环境的人来说这是工作流的重构。我先把结论摆在这M Plan 最核心的变化有三个。第一全模态额度大一统文本、语音、视频、图像不再分池子统一折算成一种计量单位你充一次值所有模态共用。第二H3 视频解禁之前 H3 系列的视频生成能力对普通开发者是锁着的现在通过 M Plan 可以直接调用包括参考生视频、分镜控制这些高级玩法。第三API Key 的打通逻辑变了以前 Claude Code、Cursor 这类工具要接 MiniMax得绕好几道弯现在 M Plan 下的 Key 可以直接喂给这些工具免密或者极简配置就能跑通。这篇文章适合谁看如果你正在用 Claude Code 写代码、用 Cursor 做 AI 辅助开发同时又想把手里的 MiniMax 额度用起来那这篇就是写给你的。如果你只是偶尔调个 API 玩玩那 M Plan 的性价比可能没那么明显但 H3 视频解禁这部分值得你关注。我会从额度体系的设计逻辑讲起然后手把手带你走一遍 Claude Code 和 Cursor 的接入流程最后把踩过的坑和排查技巧整理成表方便你直接抄作业。提示M Plan 的额度折算比例会随官方政策调整本文提到的具体数值以你实际控制台显示为准但接入逻辑和配置方法是通用的。2. M Plan 额度体系拆解为什么说这是大一统2.1 旧 Token Plan 的痛点到底在哪要理解 M Plan 的价值得先看清楚 Token Plan 的问题。Token Plan 时代MiniMax 的额度是按模态分开的文本对话一个池子语音合成一个池子视频生成又是另一个池子。每个池子有独立的配额、独立的限流、独立的计费周期。你月初充了 100 万 token 的文本额度结果这个月视频需求暴涨文本额度剩一大堆视频额度却早就见底了只能再单独充视频包。这种设计对单一模态的用户没影响但对多模态产品就是灾难。更麻烦的是限流策略。文本接口的 QPS 限制和视频接口的并发限制是分开算的你在跑一个文本生成分镜 视频渲染的流水线时经常遇到文本那边还有余量、视频这边已经排队了。调试的时候你得同时盯两个控制台排查到底是哪个模态触发了限流。我见过有团队为了绕开这个问题干脆把视频生成拆到另一个账号去跑结果账号管理又成了一笔糊涂账。Token Plan 还有一个隐性问题额度不可预测。文本 token 你能大致估算但视频生成按秒、按分辨率、按帧率计费一条 5 秒的视频到底消耗多少额度官方文档给的是范围值实际跑起来浮动很大。这就导致你没法做精确的成本预算只能拍脑袋多充点。2.2 M Plan 的折算逻辑与共享池设计M Plan 的核心思路是引入一个统一的计量单位我把它叫做模态积分。不管你调的是文本、语音还是视频系统都会根据一个折算系数把你的消耗换算成积分然后从同一个池子里扣。这个折算系数是动态的官方会根据各模态的实际资源消耗调整但对你来说你只需要关心一件事池子里还剩多少积分。这个设计的好处很直接。你这个月文本需求少、视频需求多没问题积分自动流向视频那边不会出现文本额度用不完、视频额度不够用的尴尬。反过来也一样。对于产品形态还在探索期的团队这种灵活性太重要了——你不需要提前押注哪个模态会火充一次值所有模态都能试。但这里有个坑要注意折算系数不是线性的。我实测下来视频生成的积分消耗和分辨率、时长不是简单的乘法关系。比如 720p 的 5 秒视频和 1080p 的 5 秒视频积分消耗差距可能比你想的大。官方给的解释是编码复杂度不同但实际用的时候你得自己跑几条测试视频把积分消耗记下来才能做准确的成本预估。我建议你在正式跑量之前先用最低分辨率跑 10 条再用目标分辨率跑 10 条对比积分消耗算出你自己的积分单价。2.3 H3 视频解禁参考生视频与分镜控制怎么用H3 视频解禁是这次 M Plan 最让人兴奋的部分。之前 H3 的视频能力对普通开发者是锁着的你得走特殊申请或者用企业账号才能碰。现在通过 M PlanH3 的视频接口直接开放包括参考生视频和分镜控制这两个高级功能。参考生视频的逻辑是你给一张参考图再给一段文字描述模型会生成一段视频视频的风格、构图、主体特征会尽量贴近参考图。这个功能做产品演示视频、电商商品视频特别有用。我试过用一张产品白底图做参考生成一段 5 秒的旋转展示视频效果比纯文字描述生成的要稳定得多主体不会跑偏。分镜控制则是给视频生成加了一层导演能力。你可以把一段视频拆成几个分镜每个分镜单独给提示词模型会按顺序生成再拼接。这个功能对做短剧、广告片的人价值很大。但分镜提示词的写法有讲究我后面会专门讲。注意H3 视频生成对提示词的长度有要求太短了模型理解不到位太长了又会稀释重点。我实测下来5 秒视频的提示词控制在 80 到 150 个字之间比较合适分镜提示词每个分镜 50 到 80 字。3. 免密打通 Claude Code从安装到跑通第一条命令3.1 Claude Code 的安装与基础配置Claude Code 是 Anthropic 出的命令行编程助手能在终端里直接读写文件、执行命令、跑测试。它的安装方式有好几种我用下来最稳的是通过 npm 全局安装。前提是你机器上得有 Node.js 18 以上版本这个不用多说node -v检查一下就行。安装命令很简单npm install -g anthropic-ai/claude-code装完之后直接在项目目录下敲claude就能启动。但这时候它会让你登录 Anthropic 账号或者配置 API Key。如果你只想用 MiniMax 的额度不想额外买 Anthropic 的订阅那就得走 API Key 配置这条路。Claude Code 支持通过环境变量指定 API 端点。默认情况下它连的是 Anthropic 的官方接口但你可以通过设置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量把它指向 MiniMax 的兼容接口。这就是免密打通的关键——你不需要登录 Anthropic 账号直接用 MiniMax 的 Key 就能驱动 Claude Code。配置方法是在你的 shell 配置文件里加两行。如果你用的是 bash就编辑~/.bashrc如果是 zsh就编辑~/.zshrcexport ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 export ANTHROPIC_API_KEY你的MiniMax API Key加完之后执行source ~/.bashrc或者source ~/.zshrc让配置生效。然后重新打开一个终端敲claude它就不会再让你登录了直接进入交互界面。3.2 在 VSCode 里配置 Claude Code 的完整流程很多人不习惯纯命令行操作想在 VSCode 里用 Claude Code。这个需求很合理毕竟边看代码边让 AI 改效率确实高。VSCode 里配置 Claude Code 有两种方式一种是用官方插件另一种是在 VSCode 的集成终端里直接跑 Claude Code 命令。官方插件的方式最简单在 VSCode 扩展市场搜 Claude Code 就能找到装上之后在设置里填 API Key 和 Base URL。但这里有个坑插件的设置界面有时候不认自定义的 Base URL它会强制走 Anthropic 官方接口。我试过几个版本有的能改有的不能改稳定性一般。更稳的方式是用集成终端。在 VSCode 里按Ctrl 打开终端然后直接敲claude。因为你的环境变量已经在 shell 里配好了集成终端会继承这些变量所以 Claude Code 会自动走 MiniMax 的接口。这种方式的好处是你完全掌控配置不受插件版本影响。如果你想让 Claude Code 在 VSCode 里更好用可以在项目根目录建一个.claude文件夹里面放一个settings.json配置一些项目级的参数比如默认模型、是否自动执行命令等。这个文件可以提交到 git团队共享。3.3 验证打通是否成功三个必查项配置完之后怎么确认真的打通了我一般查三个地方。第一启动 Claude Code 后随便问一个简单问题比如当前目录下有哪些文件看它能不能正常回答。如果报错说 API Key 无效或者连接超时那就是环境变量没生效或者 Key 填错了。第二看响应速度。走 MiniMax 接口的响应速度和走 Anthropic 官方接口会有差异如果你感觉明显变慢或者变快说明路由确实切过去了。但这个判断不精确只能作为辅助。第三也是最靠谱的去 MiniMax 控制台看调用记录。你每问一个问题控制台里应该会多一条调用记录模态显示为文本。如果控制台里没有记录说明请求根本没到 MiniMax 这边那肯定是 Base URL 配错了。提示Claude Code 默认用的模型名是 Anthropic 的命名MiniMax 的兼容接口会自动做映射。如果你遇到model not found的错误检查一下是不是在配置里手动指定了模型名去掉试试。4. Cursor 接入 MiniMax中文设置与模型切换实操4.1 Cursor 的下载安装与中文界面设置Cursor 是基于 VSCode 二次开发的 AI 编辑器最近半年火得不行。它的下载安装没什么好说的官网下对应平台的安装包一路下一步就行。Windows 10 上跑 Cursor 完全没问题我实测过内存占用比 VSCode 稍高一点但功能强不少。装完之后第一件事很多人想的是怎么把界面设成中文。Cursor 本身是基于 VSCode 的所以 VSCode 的中文语言包在 Cursor 里也能用。按CtrlShiftP打开命令面板输入 Configure Display Language选 Install Additional Languages然后选中文简体装完重启就行。但这里有个细节Cursor 的 AI 对话界面和编辑器界面是两套语言系统。你把编辑器设成中文了AI 回复可能还是英文。想让 AI 用中文回复得在设置里单独配。打开设置搜 cursor.chat找到语言相关的选项设成中文。或者在对话的时候直接说请用中文回复它也会照做。4.2 在 Cursor 里配置自定义模型指向 MiniMaxCursor 默认用的是自家的模型和 OpenAI 的模型想让它走 MiniMax得在设置里加自定义模型。打开 Cursor 设置找到 Models 这一栏里面有个 Add Model 的按钮。点进去之后你需要填几个东西模型名称、API Key、Base URL。模型名称这里要注意MiniMax 的兼容接口对模型名有要求。你不能随便填得填 MiniMax 支持的模型标识。具体填什么去 MiniMax 的 API 文档里查最新的模型列表。Base URL 填https://api.minimax.chat/v1API Key 填你的 M Plan Key。填完之后Cursor 会做一个连接测试。如果测试通过这个模型就会出现在模型选择列表里。你在写代码的时候按CtrlK或者CtrlL调出 AI 对话在模型下拉框里选你刚加的 MiniMax 模型就能用了。这里有个坑Cursor 的某些功能比如 Tab 自动补全可能不支持自定义模型。我实测下来对话功能是没问题的但 Tab 补全还是走 Cursor 自家的模型。这个暂时无解只能接受。4.3 免密逻辑与 API Key 的安全管理免密打通这个词听起来很爽但得说清楚它到底免的是什么密。免的是 Anthropic 账号的登录密码不是 API Key。你仍然需要一个 MiniMax 的 API Key只是这个 Key 同时能驱动 Claude Code 和 Cursor不需要为每个工具单独申请。API Key 的管理是个大事。我见过太多人把 Key 硬编码在代码里然后不小心提交到公开仓库结果被人盗刷。正确的做法是Key 只存在环境变量或者本地的配置文件里绝对不要写进代码。如果你用 Cursor可以把 Key 存在 Cursor 的设置里但要注意 Cursor 的设置文件有时候会同步到云端如果你介意就手动关掉同步。另外MiniMax 控制台里可以给 Key 设置权限和额度上限。我建议你给每个工具单独建一个 Key比如 Claude Code 一个、Cursor 一个这样万一某个 Key 泄露了你可以单独吊销不影响其他工具。额度上限也设一下防止意外跑量把积分烧光。5. 常见问题与排查技巧实录5.1 接入过程中的典型报错与解决接入 Claude Code 和 Cursor 的过程中报错是难免的。我把最常见的几个报错和解决方法整理成表你遇到的时候直接对照查。报错信息可能原因解决方法invalid api keyKey 填错或已失效去 MiniMax 控制台重新生成 Key检查有没有多余空格connection timeoutBase URL 填错或网络不通确认 URL 是https://api.minimax.chat/v1检查网络model not found模型名填错查 MiniMax 最新文档用官方支持的模型标识insufficient quota积分不足去控制台充值或检查额度是否被其他 Key 占用rate limit exceeded触发限流降低请求频率或联系官方提升配额除了这些还有一个隐蔽的问题环境变量冲突。如果你之前配过 OpenAI 的 API Key环境里可能有OPENAI_API_KEY这个变量某些工具会优先读它导致你的请求跑到 OpenAI 那边去了。排查方法是env | grep -i key看一下当前环境里有哪些 Key 相关的变量把不用的清掉。5.2 视频生成提示词的写法与分镜技巧H3 视频解禁之后很多人卡在提示词上。我总结了一套写法分三步先定主体再定动作最后定风格。主体就是视频里要出现什么比如一个白色的陶瓷杯子。动作是主体在做什么比如杯子在桌面上缓慢旋转。风格是画面的整体调性比如柔和的光线浅景深产品摄影风格。这三步写清楚5 秒视频的提示词基本就够了。分镜提示词要更细。假设你要做一个 15 秒的视频拆成三个分镜每个分镜 5 秒。第一个分镜交代环境第二个分镜展示主体第三个分镜给特写。每个分镜的提示词要独立完整不要指望模型能理解分镜之间的逻辑关系。我试过在分镜提示词里写接上一个镜头模型完全不认它只处理当前分镜的内容。注意分镜之间的过渡要自己处理。H3 生成的是独立片段拼接的时候可能会有跳变。如果你对流畅度要求高可以在提示词里统一风格描述减少跳变感。5.3 额度监控与成本控制的实操心得M Plan 的共享池设计虽然灵活但也意味着你更容易不知不觉烧光积分。我吃过这个亏有一次跑视频生成忘了设上限一晚上烧掉了大半月的额度。后来我养成了几个习惯。第一在 MiniMax 控制台设额度告警。消耗到 50%、80%、90% 的时候各发一次通知这样你有时间反应。第二给每个 Key 设单独的额度上限防止某个工具失控。第三跑批量任务之前先用小批量测试算出单条成本再决定跑不跑全量。还有一个技巧把视频生成放在低峰期跑。虽然 M Plan 没有明确的分时计费但低峰期资源充足生成成功率更高间接省了重试的积分。我一般把批量视频任务放在凌晨跑成功率比白天高不少。6. 从工具接入到工作流重构我的一些实际体会把 Claude Code 和 Cursor 都接到 MiniMax 之后我的工作流确实变了。以前写代码是想清楚再写现在是边写边让 AI 补效率提升很明显。但工具接入只是第一步真正有价值的是把额度共享这件事用起来。举个例子我现在做一个产品演示视频的流程是先用 Claude Code 写脚本和分镜提示词然后用 Cursor 调 MiniMax 的视频接口生成片段最后用文本模型生成配音文案。整个过程用的都是同一个 M Plan 额度池不需要在几个平台之间倒腾。这种流畅感是 Token Plan 时代给不了的。当然也有不爽的地方。H3 视频生成的速度还是偏慢5 秒的视频有时候要等一两分钟。分镜控制的提示词学习成本也不低我前几条视频基本都废了反复调提示词才找到感觉。但这些都是新功能早期的正常状态用熟了之后效率会上来。最后分享一个小技巧如果你同时用 Claude Code 和 Cursor建议把两个工具的 Key 分开建但在 MiniMax 控制台里把它们归到同一个项目下。这样你既能单独监控每个工具的消耗又能看到项目的总消耗做成本分析的时候特别方便。这个设置花不了几分钟但后面省的事不少。