1. 从 Token Plan 到 M Plan额度体系到底变了什么MiniMax 把原来的 Token Plan 直接送进历史换成了全新的 M Plan这件事在开发者圈子里炸开锅的原因其实很简单——过去那种按 token 分档、按模态拆开计费的模式用起来太碎了。你在做文本对话的时候剩一堆额度想跑视频又发现视频额度早就见底这种割裂感几乎每个多模态开发者都经历过。M Plan 的核心变化就是把全模态额度统一到一个池子里文本、语音、视频共享同一份额度这对同时要跑多种模态的项目来说等于把原来需要精打细算的账本直接简化成了一本账。1.1 全模态额度大一统的实际含义所谓大一统不是简单地把几个数字加在一起而是计费逻辑的重构。以前你调用文本模型消耗的是文本额度调用视频生成消耗的是视频额度两套体系互不相通。M Plan 之后你拿到的是一个统一的额度池调用任何模态都从这个池子里扣。这意味着你可以根据项目实际需求灵活分配——这个月视频生成需求大就多往视频上倾斜下个月文本对话量大额度自然流过去不需要提前做死板的预算切分。从实操角度看这个变化对两类人影响最大。一类是做多模态 Agent 的开发者他们的工作流里文本、语音、视频是串联的过去要分别管理三套额度现在只需要盯一个数字。另一类是做原型验证的团队早期阶段模态需求不稳定统一额度池让他们不用在项目还没跑通的时候就纠结买哪个档位的包。1.2 H3 视频解禁带来的能力边界扩展H3 视频模型的解禁是这次更新的另一个重头戏。之前 H3 在部分场景下是受限的尤其是涉及视频生成和导演模式director的能力很多开发者只能眼馋。现在解禁之后H3 的视频生成能力可以直接在 M Plan 体系下调用配合全模态统一额度做视频类应用的团队终于可以把文本脚本、语音旁白、视频画面串成一条完整的流水线。H3 本身在视频生成上的特点是画面连贯性和运动自然度做得比较扎实director 模式则给了更多镜头控制的空间。对于做短视频批量生产、电商商品视频、教育课件动画这类场景的团队来说H3 解禁意味着他们可以在同一个平台内完成从文案到成片的全流程不需要在多个工具之间来回倒腾素材。1.3 谁最该关注这次调整如果你只是偶尔调用一下文本接口做个小工具M Plan 的变化对你感知不强。但如果你符合下面几种情况这次调整值得你重新评估自己的技术选型项目里同时涉及文本、语音、视频三种模态且模态之间的调用比例会随业务波动正在做多模态 Agent 或工作流编排需要频繁在模态之间切换之前因为 H3 视频能力受限而不得不把视频环节外包给其他平台团队规模小没有精力维护多套额度体系和多个平台的账号提示M Plan 的额度统一不代表单价一定更低具体成本要结合你的实际调用结构来算。建议先用自己的历史调用数据做一次模拟测算再决定是否迁移。2. 免密打通 Claude Code 与 Cursor 的完整链路标题里说的免密打通指的是通过 API Key 的方式让 Claude Code 和 Cursor 这两个工具直接调用 MiniMax 的模型能力而不需要走传统的账号密码登录流程。这个链路打通之后你在 Claude Code 里写的代码、在 Cursor 里做的补全背后跑的都可以是 MiniMax 的模型。下面把整个配置过程拆开讲。2.1 先搞清楚 Claude Code 和 Cursor 各自是什么角色很多人会把这两个工具混为一谈其实它们的定位差别挺大。Claude Code 是一个命令行形态的编程助手你在终端里跟它对话它能读你的项目文件、执行命令、改代码适合习惯在终端里干活的人。Cursor 则是一个完整的 IDE基于 VS Code 深度定制把 AI 能力嵌进了编辑器里补全、对话、重构都在图形界面里完成。两者和 MiniMax 的关系是它们都支持自定义模型接入你只要把 MiniMax 的 API Key 配进去就能让它们用 MiniMax 的模型来干活。所谓免密就是跳过账号体系直接用 Key 鉴权。这样做的好处是你不需要在多个平台之间同步账号状态一个 Key 走天下。2.2 获取并管理 MiniMax API Key第一步是拿到 API Key。登录 MiniMax 的开发者平台在 API 管理页面创建一个新的 Key。创建的时候注意几点给 Key 起一个能区分用途的名字比如claude-code-dev和cursor-prod方便后续排查问题时定位如果平台支持权限范围设置只勾选你实际需要的模型权限不要图省事全开Key 创建后立即复制保存很多平台只显示一次关掉页面就再也看不到了Key 的管理有个容易被忽略的点不要把所有工具的调用都塞进同一个 Key。一旦某个 Key 泄露或者触发限流所有依赖它的工具都会受影响。按工具或按环境拆开出问题时影响面可控。2.3 在 Claude Code 中配置 MiniMax 模型Claude Code 的配置入口在它的设置文件里。不同版本的路径可能略有差异常见的位置是用户目录下的配置文件夹。你需要做的是把模型提供方指向 MiniMax 的接口地址并把 API Key 填进去。配置的核心字段通常包括配置项说明注意事项provider模型提供方标识填 MiniMax 对应的标识apiKey鉴权密钥直接填上一步拿到的 KeybaseUrl接口地址用官方文档给的地址不要自己猜model默认模型名填你要用的具体模型标识配置完成后在 Claude Code 里发一条测试消息看是否能正常返回。如果报鉴权错误先检查 Key 有没有多余空格如果报模型不存在检查 model 字段拼写。2.4 在 Cursor 中接入 MiniMax 并设置中文回复Cursor 的模型配置在设置面板的模型区域。它支持添加自定义模型你把 MiniMax 的接口信息和 Key 填进去就行。这里有个细节Cursor 默认可能会走它自己的模型列表你需要手动切换到自定义模型否则配置了也不会生效。关于中文回复的设置这是热词里问得最多的问题之一。Cursor 的回复语言取决于两个因素一是模型本身对中文的支持程度二是你在对话时使用的语言。如果你希望它稳定用中文回复最直接的办法是在系统提示词或者项目规则里明确写上请始终使用中文回复。光靠界面语言设置成中文是不够的那只影响菜单显示不影响模型输出。具体操作路径大致是打开设置找到 Rules 或自定义指令的区域添加一条中文回复的规则。这样每次对话时这条规则都会作为上下文传给模型回复语言就稳定了。2.5 验证链路是否真正打通配置完之后别急着干活先做一轮验证。验证分三层连通性验证发一条最简单的消息确认能收到回复排除网络和鉴权问题模型验证问一个能体现模型特征的问题确认背后跑的确实是你配置的模型而不是回退到了默认模型能力验证让它读一个项目文件、改一段代码确认文件读写和代码操作权限正常三层都过了才算真正打通。很多人卡在第二层以为配置好了其实 Cursor 悄悄回退到了内置模型用起来感觉不对但找不到原因。3. 配置过程中最容易踩的五个坑这部分是我自己在配这套链路时实际遇到的问题以及从社区里看到的高频故障。提前知道这些能省下不少排查时间。3.1 Key 填了但一直报鉴权失败最常见的原因是复制 Key 的时候带上了首尾空格或者换行符。从网页复制的内容经常会有不可见字符粘到配置文件里肉眼看不出来但鉴权就是过不了。解决办法是把 Key 粘到纯文本编辑器里过一遍确认没有多余字符再填进去。另一个原因是 Key 的权限范围没包含你要调用的模型。有些平台创建 Key 时可以限定可访问的模型列表如果你只勾了文本模型却想调视频能力就会报鉴权失败。这种情况报错信息往往比较模糊容易误判成 Key 本身有问题。3.2 模型名写错导致静默回退这个坑比较隐蔽。有些工具在你填的模型名不存在时不会直接报错而是静默回退到默认模型。你感觉配置生效了实际上跑的还是老模型。判断方法是看响应里的模型标识字段或者问一个只有目标模型才知道答案的问题。模型名的拼写要以官方文档为准不要凭记忆写。MiniMax 的模型命名有自己的规则大小写、连字符都可能影响识别。3.3 网络环境导致的超时调用外部接口时网络稳定性直接影响体验。如果你发现请求经常超时或者间歇性失败先排查网络链路。可以先用命令行工具直接请求接口地址看响应时间是否正常。如果命令行都超时那就是网络问题跟工具配置无关。对于国内用户接口的响应速度还跟接入点有关。如果平台提供了多个接入地址选一个延迟低的。这个用简单的 ping 或者 curl 测一下响应时间就能判断。3.4 Cursor 中文设置改了但回复还是英文前面提过界面语言和回复语言是两回事。很多人把 Cursor 的界面切成中文以为模型就会用中文回复结果发现还是英文。真正起作用的是对话时的指令。你可以在每次对话开头加一句用中文回答或者更省事的办法是在项目规则里写死这条要求。如果加了规则还是英文检查规则有没有被正确加载。有些规则文件需要放在特定目录下才会被识别放错位置等于没写。3.5 多工具共用 Key 导致的限流Claude Code 和 Cursor 如果共用同一个 Key当两边同时高频调用时很容易触发平台的速率限制。表现是突然开始报错过一会儿又好了。解决办法是按工具拆分 Key各自独立计数。这样即使一个工具跑满了也不影响另一个。4. H3 视频能力在 M Plan 下的实际用法H3 解禁之后视频生成从看得见摸不着变成了可以直接调用的能力。这一章讲清楚 H3 在 M Plan 体系下怎么用以及和文本、语音模态怎么配合。4.1 H3 视频生成的基本调用逻辑H3 的视频生成走的是异步任务模式。你提交一个生成请求平台返回一个任务 ID然后你轮询或者通过回调获取结果。这个模式和大多数视频生成服务一致因为视频渲染耗时较长同步返回不现实。调用时需要提供的核心参数包括文本描述prompt、视频时长、分辨率、风格倾向。director 模式下还能指定镜头运动、转场方式等更细粒度的控制。参数越细生成结果越可控但配置复杂度也越高。4.2 文本、语音、视频的串联工作流M Plan 统一额度之后最有价值的用法是把三种模态串起来。举个实际场景你要做一批产品介绍视频。流程可以是用文本模型根据产品资料生成视频脚本用语音模型把脚本转成旁白音频用 H3 根据脚本和旁白生成视频画面把音频和视频合成最终成片这条流水线里每一步的额度都从同一个池子扣你不需要在步骤之间切换账号或者充值。对于批量生产的场景这种连贯性带来的效率提升很明显。4.3 本地部署 H3 的可行性判断热词里有人问 H3 本地部署这里说下判断逻辑。本地部署的前提是你的硬件能扛住模型推理的显存和算力需求。H3 作为视频生成模型对显存的要求不低普通消费级显卡跑起来会比较吃力。如果你只是做小规模验证云端调用更划算如果有数据不出本地的硬性要求再考虑本地部署并且要提前确认硬件配置是否达标。本地部署还需要考虑模型文件的获取、推理框架的搭建、依赖环境的配置这些工作量不小。没有明确的离线需求不建议一上来就折腾本地部署。5. 从 Token Plan 迁移到 M Plan 的实操建议如果你之前在用 Token Plan迁移到 M Plan 不是改个配置就完事有几个地方需要提前规划。5.1 先盘点自己的历史调用结构迁移前先拉一份过去几个月的调用数据看看文本、语音、视频各占多少比例峰值调用量出现在什么时段。这份数据决定了你在 M Plan 下需要多大的额度池。如果视频占比高就要按视频的消耗速度来估算如果文本为主额度压力会小很多。盘点的时候注意区分测试流量和生产流量。测试阶段的调用往往很零散参考价值有限重点看生产环境的稳定消耗。5.2 重新设计 Key 的分配策略M Plan 下额度统一了但 Key 还是要分开管理。建议按环境和用途两个维度来拆开发环境一个 Key生产环境一个 Key文本调用和视频调用如果量都很大也可以拆开给每个 Key 设置用量告警接近阈值时提前收到通知这样做的目的是让问题可定位。如果所有调用挤在一个 Key 里一旦出问题你连是哪个环节导致的都分不清。5.3 迁移后的监控要点迁移完成后头两周要重点盯几个指标调用成功率、平均响应时间、额度消耗速度。成功率下降可能是配置问题响应时间变长可能是网络或平台负载问题额度消耗速度异常则可能是某个环节的调用量失控。建议做一个简单的监控看板把这些指标可视化。不需要多复杂一个表格记录每天的调用量和消耗就行。有了基线数据后面出问题时才有对比依据。6. 关于 Claude Code 与 Cursor 配合使用的经验最后聊一下这两个工具怎么配合用效率最高。我的习惯是Cursor 负责日常的代码编写和补全因为图形界面里改代码更直观Claude Code 负责批量操作和脚本化的任务比如批量重命名文件、批量改配置、跑测试并分析结果。两者各有所长不是替代关系。配置上两个工具用不同的 Key避免限流互相影响。模型选择上日常补全用响应快的模型复杂推理任务用能力强的模型根据任务类型切换。这样既保证体验又控制成本。还有一点不管用哪个工具都要定期检查它实际调用的模型是不是你配置的那个。工具更新后配置被重置的情况时有发生养成定期验证的习惯能避免很多莫名其妙的变笨问题。
