1. 从 Token Plan 到 M Plan这次改动到底动了谁的蛋糕如果你最近两个月一直在用 MiniMax 的 API 做多模态应用大概率经历过这种糟心事文本模型一个额度池、语音合成一个额度池、视频生成又是另一个额度池月底对账的时候得开三个后台页面来回切换稍不留神某个池子跑超了业务直接卡死。Token Plan 这套按模态分账的逻辑说实话在单模态时代还能凑合但到了 2025 年下半年谁家产品不是文本加语音加视频混着跑分账模式就成了纯粹的负担。M Plan 的出现本质上是把按模态切分改成了按总量统管。你充一笔额度文本、语音、视频、图像全部从同一个池子里扣后台只显示一个剩余数字。这个改动听起来简单但背后牵扯的是计费引擎的重构——不同模态的计量单位完全不一样文本按 token、语音按字符或秒、视频按生成时长和分辨率要把这些折算成统一的点数需要一套换算系数。MiniMax 官方给出的折算逻辑是文本 1K token 约等于 1 点语音合成 1K 字符约等于 2 点视频生成按 5 秒 720P 为基准约等于 30 点。这个系数不是随便定的它大致反映了各模态的算力成本比例。H3 视频解禁是另一个重磅。之前 H3 模型只对部分企业客户开放普通开发者账号根本调不到视频生成接口现在 M Plan 用户可以直接用。H3 在运动一致性和镜头语言理解上比上一代强不少尤其是分镜提示词的解析能力你写镜头从远景推近到人物面部特写背景虚化这种描述它能比较准确地执行。这对于做短视频批量生成的工作室来说等于省掉了一个分镜师的人力。那这套东西适合谁三类人最该关注一是独立开发者一个人维护多个模态的 AI 应用分账模式能把人逼疯二是小型内容团队需要批量生成视频素材但预算有限三是已经在用 Claude Code 或 Cursor 做开发、想把手里的模型额度统一管理的工程师。如果你只是偶尔调一下文本接口那 M Plan 对你的感知不会太强但如果你是多模态重度用户这次改动值得花半小时重新配置一遍。2. M Plan 额度大一统的底层逻辑与实操配置2.1 为什么大一统比分模态更划算先算一笔账。假设你一个月文本消耗 500 万 token、语音合成 20 万字符、视频生成 100 条 5 秒 720P。按旧的分模态套餐你得分别买三档套餐每档都有最低消费门槛加起来月支出大概在 800 到 1000 元区间而且经常出现文本池用完了但语音池还剩一大半的情况浪费率保守估计在 20% 以上。换成 M Plan 之后同样的用量折算成点数文本 5000 点、语音 400 点、视频 3000 点合计 8400 点。M Plan 的中档套餐给的是 10000 点月费 699 元。省下来的不只是钱更重要的是你不用再盯着三个池子做预算分配了。这种总量池模式在云服务里其实很常见AWS 的 Credit 机制、阿里云的资源包都是类似思路MiniMax 只是把这个逻辑搬到了多模态 AI 服务上。注意折算系数会随模型版本更新调整配置前务必在控制台的额度说明页面确认当前系数不要拿旧文章的数字直接套。2.2 控制台配置的完整步骤第一步登录 MiniMax 开放平台进入账户中心找到套餐管理。如果你之前买过 Token Plan会看到一个迁移到 M Plan的按钮。这里有个坑迁移不是自动的你得手动点而且迁移后旧套餐的剩余额度会按折算系数转成点数但有效期不延长还是按原套餐的到期日算。所以如果你的 Token Plan 还有三天到期别急着迁移等它自然到期再买 M Plan 更划算。第二步选择套餐档位。目前 M Plan 分三档基础版 3000 点/月、标准版 10000 点/月、专业版 50000 点/月。选档位的依据不是看你历史用量而是看你未来一个月的业务峰值。我的经验是按历史峰值的 1.5 倍来选因为额度用超之后按量计费的单价会比套餐内单价贵 30% 左右。第三步配置 API Key 的权限范围。M Plan 下你可以给同一个 Key 同时开通文本、语音、视频权限也可以分开建多个 Key 做权限隔离。这里建议按业务线分 Key比如客服机器人用一个 Key 只开文本和语音营销视频用另一个 Key 只开视频。这样做的好处是万一某个 Key 泄露了损失可控而且后台的用量统计能按 Key 维度看方便做成本归因。第四步设置额度告警。在用量监控里可以设置阈值告警建议设两档80% 时邮件提醒95% 时短信提醒。别小看这个我见过太多团队因为没设告警月底最后一天额度跑超业务直接中断。2.3 H3 视频接口的调用要点H3 解禁后接口路径是/v1/video/generation和之前的视频接口比多了一个model参数值填minimax-h3。请求体里最关键的是prompt字段H3 对分镜描述的理解能力是它的核心卖点但很多人写提示词的方式不对。错误写法一个人在海边散步夕阳很美。这种写法 H3 也能生成但出来的东西很随机镜头运动基本靠运气。正确写法要包含四个要素镜头类型、主体动作、环境细节、运镜方式。比如中景镜头一位穿白色衬衫的男性沿着海岸线缓慢行走背景是橙红色夕阳和海面反光镜头从侧面跟随平移景深虚化背景。这样写出来的视频镜头语言是可控的。生成 5 秒视频的提示词实测下来 60 到 120 个中文字符效果最好。太短了信息不足太长了模型会忽略后面的描述。如果你要生成更长的视频H3 支持分段生成再拼接但要注意段与段之间的首尾帧衔接建议每段结尾留 0.5 秒的静止画面方便后期剪辑时做转场。3. 免密打通 Claude Code 与 Cursor 的完整实操3.1 为什么要在 Claude Code 里接 MiniMaxClaude Code 是 Anthropic 出的命令行编程助手默认走的是 Claude 系列模型。但国内开发者用起来有两个痛点一是订阅访问经常受限二是按量计费的成本不透明。MiniMax 的 M Plan 提供了兼容 OpenAI 格式的接口而 Claude Code 支持自定义 API 端点这就给了我们换芯的空间。把 Claude Code 的后端换成 MiniMax好处有三个额度统一管理不用单独给 Claude 充值成本可预测M Plan 是包月制模型切换灵活MiniMax 的文本模型在代码生成任务上表现不差尤其是中文注释和技术文档生成比 Claude 更贴合国内开发习惯。3.2 Claude Code 的安装与环境变量配置先装 Claude Code。Windows 10 用户打开 PowerShellMac 和 Ubuntu 用户打开终端执行npm install -g anthropic-ai/claude-code装完之后不要急着运行claude命令先配置环境变量。Claude Code 读取的是ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL这两个变量。我们要做的是把 Base URL 指向 MiniMax 的兼容端点把 API Key 换成 MiniMax 的 Key。Windows 10 下在 PowerShell 里执行$env:ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 $env:ANTHROPIC_API_KEY你的MiniMax API KeyMac 和 Ubuntu 下在~/.bashrc或~/.zshrc里加export ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 export ANTHROPIC_API_KEY你的MiniMax API Key然后source ~/.zshrc让配置生效。注意MiniMax 的兼容端点路径是/v1不要写成/v1/chat/completionsClaude Code 会自己拼接后面的路径。写错了会报 404。配置完之后运行claude如果能看到交互界面并且能正常对话说明打通了。如果报your organization has disabled claude subscription access这个错说明环境变量没生效检查一下是不是在错误的 shell 里配置的或者有没有重启终端。3.3 Cursor 的自定义模型配置与中文设置Cursor 的配置比 Claude Code 直观一些因为它是图形界面。打开 Cursor按CtrlShiftPMac 是CmdShiftP调出命令面板输入 Open Settings找到 Models 选项卡。在 OpenAI API Key 那一栏填入 MiniMax 的 Key然后在 Override OpenAI Base URL 里填https://api.minimax.chat/v1。接着在 Model 下拉框里如果列表中没有 MiniMax 的模型选 Add Model 手动输入模型名比如abab6.5s-chat或 MiniMax 最新的文本模型标识。这里有个细节Cursor 默认会验证 API Key 的有效性如果 MiniMax 的兼容接口在响应格式上和 OpenAI 有细微差异可能会验证失败。实测下来MiniMax 的/v1/chat/completions接口是兼容 OpenAI 格式的验证能通过。如果遇到验证失败检查一下 Key 有没有开通文本权限以及账户余额是否充足。Cursor 的中文设置分两块。界面语言在CtrlShiftP里输入 Configure Display Language选 中文简体 即可。但 AI 回复的语言是另一回事需要在 Settings 的 Rules for AI 里加一条规则Always respond in Chinese. 这样 Cursor 的 AI 对话就会用中文回复。很多人只改了界面语言发现 AI 还是回英文就是漏了这一步。3.4 免密登录的实现思路所谓免密不是真的不要密码而是把 API Key 存在环境变量或配置文件里不用每次手动输入。Claude Code 和 Cursor 都支持从环境变量读取 Key所以只要你把环境变量配好后续启动就是免密的。但这里有个安全隐患环境变量在有些系统上会被其他进程读取到。更安全的做法是用.env文件加dotenv加载或者用系统的密钥管理工具。对于个人开发机环境变量够用了如果是团队共用的服务器建议用密钥管理服务每个开发者分配独立的 Key。4. 常见报错与排查技巧实录4.1 API Key 相关的典型报错llm-deepseek: no api key for provider route deepseek-official这个报错看起来是 DeepSeek 的问题但实际上经常出现在你配置了多个模型提供商、路由没配对的情况下。Cursor 和 Claude Code 都支持多提供商配置如果你同时配了 DeepSeek 和 MiniMax但没有指定默认路由工具可能会随机选一个提供商选到没配 Key 的那个就报这个错。解决办法是在配置文件里明确指定默认提供商。Cursor 在 Settings 的 Models 里有一个 Default Model 选项选成 MiniMax 的模型。Claude Code 则在~/.claude/config.json里设置defaultProvider字段。your organization has disabled claude subscription access for claude code这个报错前面提过是环境变量没生效。但还有一种情况你的机器上同时装了多个版本的 Claude Code旧版本读的是旧的配置文件路径。用which claude确认一下当前用的是哪个版本然后npm update -g anthropic-ai/claude-code更新到最新版。4.2 视频生成失败的排查路径H3 视频生成失败按这个顺序排查排查项检查方法常见问题额度是否充足控制台查看剩余点数视频消耗点数大容易超模型权限API Key 是否开通视频权限默认 Key 可能只开了文本提示词长度统计中文字符数超过 200 字容易被截断分辨率参数检查请求体 resolution 字段不支持的分辨率会直接报错并发限制查看是否同时发起多个请求免费档并发数很低我踩过最坑的一次是提示词里带了英文引号JSON 解析失败但报错信息很模糊只显示 invalid request。后来把提示词里的特殊字符都转义了才通过。所以写提示词的时候尽量用中文标点避免嵌套引号。4.3 Cursor 跳转和中文回复的细节问题有人问 Cursor 能不能像 Source Insight 那样跳转代码块。答案是能但需要装语言插件。Cursor 基于 VS CodeVS Code 的代码跳转靠的是 Language Server你装了对应的语言扩展比如 Python 装 PylanceC 装 C/C 扩展跳转功能就和 Source Insight 一样好用。没装扩展的话只能做文本搜索式的跳转不准。Cursor 设置中文回复除了前面说的 Rules for AI还有一个更彻底的方法在项目根目录建一个.cursorrules文件里面写 所有回复使用简体中文代码注释也用中文。 这个文件对当前项目生效比全局设置更灵活。团队协作时把.cursorrules提交到 Git 仓库所有人的 Cursor 都会遵循同样的规则。4.4 本地模型接入的注意事项有人想在 Claude Code 里调 LM Studio 的本地模型。技术上可行把ANTHROPIC_BASE_URL指向 LM Studio 的本地端口默认http://localhost:1234/v1Key 随便填一个非空字符串。但要注意LM Studio 的接口兼容性不如 MiniMax 这种商业 APIClaude Code 的一些高级功能比如工具调用、流式响应可能不支持。实测下来简单的对话能跑但涉及到文件读写、终端命令执行这些 Claude Code 的核心功能本地模型经常掉链子。如果你只是想在本地做代码补全用 Cursor 接 LM Studio 体验更好因为 Cursor 对本地模型的支持更成熟。Claude Code 的设计初衷就是配合云端模型做 Agent 式编程本地模型不是它的主战场。5. 多模态额度管理的长期策略M Plan 解决了额度统一的问题但统一之后怎么管是另一个课题。我的做法是建一个简单的用量台账每天记录各模态的点数消耗用 Excel 或 Notion 都行。记录一周之后你就能看出用量规律工作日文本消耗大周末视频生成多月底最后几天因为赶项目会有一个峰值。基于这个规律可以做两件事。一是动态调整套餐档位如果连续三个月峰值都没超过当前档位的 70%就降一档如果连续两个月都跑到 90% 以上就升一档。二是做预算预警把月度预算拆到周每周一检查上周用量超了就收紧非必要调用。还有一个容易被忽略的点M Plan 的点数月底清零不结转。所以月底最后几天如果点数还剩很多可以集中跑一些批量任务比如批量生成下个月要用的视频素材或者批量做文本数据清洗。但别为了用而用生成一堆用不上的东西那是另一种浪费。对于团队用户建议给每个成员分配独立的 API Key然后在控制台按 Key 看用量。这样能清楚地知道谁在消耗额度避免公地悲剧。如果某个成员的用量异常高先别急着批评看看是不是他的业务线本身就需要大量调用如果是那就该给他单独申请额度。H3 视频解禁之后视频生成的点数消耗会成为大头。一条 5 秒 720P 视频 30 点一天生成 100 条就是 3000 点一个月就是 90000 点直接超过专业版的额度。所以做视频批量生成之前一定要先算清楚成本别等额度跑超了才发现账单爆炸。我的建议是视频生成任务先小批量测试确认提示词效果稳定了再放大批量而且尽量在本地做好分镜脚本减少无效生成。最后分享一个我自己的配置习惯把 MiniMax 的 API Key 按环境分三个开发环境一个、测试环境一个、生产环境一个。开发环境的 Key 额度设低一点防止调试代码时不小心跑飞生产环境的 Key 设额度告警并且只给必要的权限。这样即使开发环境的 Key 泄露了也不会影响生产业务。这个习惯是从传统后端开发里带过来的用在 AI API 管理上同样有效。
