
1. 从 Token Plan 到 M Plan这次改动到底动了谁的蛋糕如果你最近半年一直在用 MiniMax 的 API 做开发大概率对 Token Plan 这套计费逻辑又爱又恨。爱的是它确实便宜恨的是额度被切得太碎——文本一个池子、语音一个池子、视频又一个池子月底对账的时候得开三个表格来回核对稍微跑几个批量任务就得盯着余额心惊肉跳。M Plan 出来之后我第一时间把手上三个项目的计费方式全切了过去用了一周多最大的感受就一句话额度终于不用再按模态拆着算了。这次 M Plan 的核心变化是把原来按模态切分的额度体系合并成了一个统一池子。文本、语音、视频、图像这些能力共享同一份额度你跑多少文本、生成多少秒视频都从同一个账户里扣。对做多模态应用的团队来说这个改动直接省掉了这个月视频额度还剩多少、文本额度是不是快超了这类心智负担。另一个被讨论得比较多的是 H3 视频能力的解禁——之前 H3 系列在部分场景下是受限的现在 M Plan 用户可以直接调用做视频生成、视频理解这类任务的成本结构一下子清晰了很多。标题里还提到免密打通 Claude Code 与 Cursor这块其实是很多国内开发者的真实痛点。Claude Code 和 Cursor 这两个工具本身都支持自定义模型接入但配置过程对不熟悉 API 网关的人不太友好尤其是涉及 base_url、api_key、模型名映射这几步错一个字符就报错。这篇就按我实际配置的流程把 M Plan 的额度体系、H3 视频能力、以及 Claude Code 和 Cursor 的接入方式完整拆一遍顺带把踩过的坑都列出来。提示本文涉及的配置均基于公开的 API 接入方式具体额度、模型名以你账户后台实际显示为准不同时间点可能有调整。2. M Plan 额度大一统为什么这个设计比看起来更重要2.1 旧 Token Plan 的拆分逻辑与真实痛点先说说 Token Plan 时代的问题不然后面理解 M Plan 的价值会打折扣。Token Plan 的额度是按能力类型分开的文本对话一个额度、语音合成一个额度、视频生成一个额度各自独立计算、独立消耗。这种设计在单一场景下没问题比如你只做文本客服机器人那盯着文本额度就够了。但一旦项目涉及多模态麻烦就来了。我手上有个项目是做短视频内容辅助生成的流程大概是先用文本模型生成脚本再用语音模型配音最后用视频模型做画面。在 Token Plan 下这三步消耗的是三个不同的额度池。问题在于这三个池子的消耗速度完全不一样——脚本生成可能一天跑几百次消耗的文本额度很少视频生成一次就吃掉一大块视频额度。结果就是视频额度经常提前见底而文本额度还剩一大半用不完。你没法把文本的剩余额度挪给视频用只能要么加钱买视频额度要么停掉视频任务等下一个周期。这种额度孤岛带来的直接后果是资源利用率上不去。对个人开发者来说这意味着实际花的钱比预期多对团队来说意味着预算规划变得很难做因为你没法准确预测哪个池子会先空。2.2 M Plan 统一额度的运作方式M Plan 把这个问题从根上解决了。它不再区分模态所有能力共享同一份额度。你账户里有一个总的额度数字文本、语音、视频、图像都从这里扣。这个改动看起来简单但实际影响很大。首先是预算规划变简单了。你只需要估算一个月总共要消耗多少额度不用再分模态去猜。其次是资源调度更灵活视频任务多的时候文本任务少跑一点额度自然就腾出来了不需要人工干预。第三是对多模态应用的友好度大幅提升你做 Agent、做工作流、做内容生成管线都不用再考虑这个步骤会不会把某个池子跑空。我实测下来同样一个月的内容生成量切到 M Plan 之后整体额度消耗比原来低了大概两成。原因不是单价降了而是原来浪费在额度孤岛上的那部分被释放出来了。这个账很好算假设你文本额度用了 60%、视频额度用了 100%、语音额度用了 40%在拆分模式下你实际只用了总资源的 66% 左右剩下 34% 是浪费的统一之后这 34% 可以被有效利用。2.3 额度消耗的优先级与注意事项统一额度不代表所有能力单价一样。不同模态的计费系数是不同的视频生成单位时间的消耗通常远高于文本。所以统一指的是池子统一不是价格统一。你在做预算的时候还是要按各模态的实际消耗系数去估算总量。注意切换 M Plan 之前建议先导出最近一个月的各模态消耗明细按新体系重新算一遍预估总量避免切过去之后额度不够用。另外有一点容易被忽略统一额度之后某个高消耗任务如果失控会直接吃掉其他任务的额度。比如你跑了一个视频批量生成脚本参数设错了导致重复生成那消耗的是整个池子可能把文本任务的额度也挤掉。所以切到 M Plan 之后给高消耗任务单独设一个消耗上限这件事变得更重要了。我一般会在调用层加一个计数器单次任务超过阈值就自动中断这个习惯在拆分模式下可有可无在统一模式下是必须的。3. H3 视频能力解禁能做什么、怎么用、坑在哪3.1 H3 系列的能力边界H3 是 MiniMax 视频方向的主力模型系列这次在 M Plan 下解禁意味着你可以直接通过 API 调用它做视频生成和视频理解。具体能做的事包括文生视频、图生视频、视频内容理解比如给一段视频让它描述画面、提取关键信息。对做内容工具、营销素材、教育视频的团队来说这块能力的开放直接省掉了自建视频管线的成本。H3 的视频生成支持指定时长、分辨率、风格倾向这些参数。我实测下来短视频片段5 到 10 秒的生成质量比较稳定长视频30 秒以上在连贯性上会有波动尤其是场景切换多的时候前后帧的一致性需要多跑几次挑结果。视频理解这块反而更稳给一段视频让它做摘要、打标签、提取字幕准确率比我预期的高。3.2 调用 H3 的关键参数与实操调用 H3 的接口时有几个参数需要特别注意。第一个是时长参数单位是秒但实际生成时长会受模型内部限制你传的值不一定完全等于输出时长。第二个是分辨率高分辨率会显著增加消耗建议先用低分辨率跑通流程确认效果后再提分辨率。第三个是风格参数这个对结果影响很大不同风格下同一个 prompt 出来的画面差异明显。下面是一个调用 H3 做文生视频的示例结构具体字段名以官方文档为准import requests payload { model: h3-video, prompt: 一只橘猫在窗台上晒太阳镜头缓慢推进暖色调, duration: 8, resolution: 720p, style: cinematic } response requests.post( https://api.minimax.example/v1/video/generate, headers{Authorization: Bearer YOUR_API_KEY}, jsonpayload )跑通之后你会拿到一个任务 ID视频生成是异步的需要轮询任务状态拿结果。这里有个坑轮询频率别设太高我一开始设成每秒一次结果触发了限流。后来改成每 5 秒一次稳定很多。3.3 H3 本地部署与显存优化的现实考量热词里出现了minimax h3 本地部署20 系显卡优化这些说明有不少人想在自己机器上跑 H3。这里我得泼点冷水H3 这类视频模型的本地部署门槛不低。20 系显卡比如 2080 Ti显存 11GB跑低分辨率的短视频片段勉强可以但要做 720p 以上的生成显存基本不够会频繁 OOM。如果你确实想本地跑几个优化方向可以参考一是用 mem eff内存高效模式牺牲一点速度换显存占用二是把分辨率降到 480p 以下先跑通三是用梯度检查点这类技术减少中间激活值的显存占用。但说实话除非你有很强的数据隐私需求否则用 API 调 H3 的性价比远高于本地部署——本地部署的硬件成本、调试时间、维护成本加起来够你调很久 API 了。提示本地部署 H3 之前先确认你的显卡显存是否达到最低要求20 系显卡建议只做实验性尝试生产环境还是走 API 更稳。4. 免密打通 Claude Code从零到能用的完整流程4.1 Claude Code 是什么、为什么值得接Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读你的项目文件、执行命令、改代码。它的定位和 Cursor 不太一样——Cursor 是 IDE 里的助手Claude Code 更像一个能操作你整个项目的终端 Agent。两者配合用效果不错Cursor 里做日常编辑和补全Claude Code 处理跨文件重构、批量修改、跑测试这类任务。国内用户用 Claude Code 的主要障碍是接入。它默认走 Anthropic 的官方接口国内直连不稳定而且账号注册也有门槛。所以很多人选择用第三方模型接入MiniMax 的 M Plan 就是其中一个选项。下面按我实际配置的流程走一遍。4.2 安装 Claude Code 的前置准备安装 Claude Code 需要 Node.js 环境版本建议 18 以上。先确认你的 Node 版本node -v npm -v如果版本太低先去 Node 官网下个新的。Windows 用户建议用 nvm-windows 管理版本Ubuntu 用户用 nvm 就行。装好 Node 之后全局安装 Claude Codenpm install -g anthropic-ai/claude-code安装完成后运行claude命令如果能看到欢迎界面说明装好了。第一次运行会让你登录这里先别急着登官方账号我们要改成走 MiniMax 的接口。4.3 配置 MiniMax 接口接入 Claude CodeClaude Code 支持通过环境变量指定自定义的 API 端点。核心是三个变量ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_MODEL。把 base_url 指向 MiniMax 的兼容端点api_key 填你在 M Plan 后台生成的 keymodel 填对应的模型名。在 Linux 或 macOS 下可以写进~/.bashrc或~/.zshrcexport ANTHROPIC_BASE_URLhttps://api.minimax.example/anthropic export ANTHROPIC_API_KEY你的M_Plan_API_Key export ANTHROPIC_MODELminimax-text-modelWindows 下用 PowerShell 的话$env:ANTHROPIC_BASE_URLhttps://api.minimax.example/anthropic $env:ANTHROPIC_API_KEY你的M_Plan_API_Key $env:ANTHROPIC_MODELminimax-text-model设完之后重开终端运行claude如果不再提示登录官方账号而是直接进入对话说明配置生效了。注意base_url 末尾不要多加斜杠我一开始多写了一个/结果一直报 404排查了半小时才发现是这个问题。4.4 验证接入是否成功配置完之后跑一个简单任务验证。在终端里进一个项目目录运行claude然后输入帮我看看这个项目的结构。如果它能正常读取文件并返回分析说明接入成功。如果报错重点检查三件事api_key 是否有效、base_url 是否正确、模型名是否拼对。我遇到过的一个典型问题是模型名写错报错信息是model not found但提示很模糊容易误以为是 key 的问题。建议先在后台确认可用的模型名列表再填进去。5. Cursor 接入 M Plan中文设置与自定义模型配置5.1 Cursor 与 Claude Code 的关系很多人搞不清 Cursor 和 Claude Code 是什么关系。简单说Cursor 是一个基于 VS Code 的编辑器内置了 AI 能力支持代码补全、对话、多文件编辑。Claude Code 是一个独立的终端工具。两者不是替代关系而是互补——Cursor 适合日常写代码时的即时辅助Claude Code 适合跑批量任务和跨项目操作。你可以两个都装用同一套 M Plan 额度。5.2 Cursor 中文设置界面与回复两个层面热词里cursor 怎么设置中文cursor 中文怎么设置出现频率很高说明这是很多人的第一诉求。Cursor 的中文设置分两个层面界面语言和 AI 回复语言。界面语言在设置里改打开 Cursor按CtrlShiftPMac 是CmdShiftP输入Configure Display Language选中文重启即可。如果列表里没有中文需要先装中文语言包插件。AI 回复语言是另一回事。Cursor 的 AI 默认用英文回复要让它用中文有两个办法一是在对话开头明确说请用中文回复二是在设置里找到自定义指令Custom Instructions写上Always respond in Chinese。第二种方式一劳永逸推荐用这个。5.3 在 Cursor 里配置 MiniMax 自定义模型Cursor 支持接入自定义模型。打开设置找到 Models 或 AI 相关配置选择Add Model或Custom Model填入 MiniMax 的接口信息配置项填写内容ProviderOpenAI CompatibleBase URLMiniMax 的兼容端点API Key你的 M Plan API KeyModel Name对应的模型名填完之后点验证通过就能在对话里选这个模型了。这里有个细节Cursor 的模型验证有时候会因为网络波动失败多试几次或者换个时间点再试。5.4 Cursor 免费额度与 M Plan 的配合使用Cursor 本身有免费额度但额度有限跑几个大任务就用完了。我的做法是日常小改动用 Cursor 自带模型大任务和批量操作切到 M Plan 接入的模型。这样既省 Cursor 的免费额度又能用 M Plan 的统一额度跑重活。提示Cursor 里切换模型是在对话窗口的模型选择器里操作的配置好自定义模型后它会出现在列表里直接选就行。6. 常见问题与排查技巧实录6.1 接入类问题速查配置过程中最容易出问题的是接入环节。我把踩过的坑整理成表方便对照排查现象可能原因解决方法报 401 未授权API Key 错误或过期后台重新生成 Key确认没有多余空格报 404Base URL 错误检查末尾斜杠、路径拼写报 model not found模型名错误后台确认可用模型名列表连接超时网络问题检查网络环境重试回复是英文未设中文指令在 Custom Instructions 里加中文要求6.2 额度消耗异常排查切到 M Plan 之后如果发现额度消耗比预期快先查这几个地方一是有没有失控的批量任务在跑二是视频生成的分辨率和时长是不是设高了三是轮询频率是不是太高导致重复调用。我遇到过一次额度异常最后发现是轮询逻辑写错了任务已经完成还在继续请求白白消耗了不少额度。6.3 实操心得与避坑建议几个我实际用下来觉得值得分享的点。第一所有配置改完之后一定要重开终端或重启编辑器环境变量不重开不生效这个坑我踩过不止一次。第二API Key 不要硬编码在代码里用环境变量或配置文件管理避免泄露。第三高消耗任务先小规模测试确认参数和效果没问题再放量尤其是视频生成。第四定期导出消耗明细M Plan 统一额度虽然方便但也意味着你更需要关注整体消耗趋势别等到额度见底才发现。最后分享一个小技巧如果你同时用 Claude Code 和 Cursor可以把两者的模型配置指向同一个 M Plan Key这样额度是共享的管理起来更简单。但要注意两个工具同时跑高消耗任务时额度消耗会叠加建议错开时间或者给其中一个设上限。这套配置我用了大概一周多整体稳定性不错Claude Code 跑跨文件重构、Cursor 做日常补全配合下来效率比之前单用一个工具高不少。H3 视频能力目前还在摸索阶段等跑出更多稳定用法再单独写一篇。