企业官网建设流程全解析

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 Plan，H3 的视频接口直接开放，包括参考生视频和分镜控制这两个高级功能。

参考生视频的逻辑是：你给一张参考图，再给一段文字描述，模型会生成一段视频，视频的风格、构图、主体特征会尽量贴近参考图。这个功能做产品演示视频、电商商品视频特别有用。我试过用一张产品白底图做参考，生成一段 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，就编辑~/.zshrc：

export ANTHROPIC_BASE_URL="https://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 里也能用。按Ctrl+Shift+P打开命令面板，输入 "Configure Display Language"，选 "Install Additional Languages"，然后选中文简体，装完重启就行。

但这里有个细节：Cursor 的 AI 对话界面和编辑器界面是两套语言系统。你把编辑器设成中文了，AI 回复可能还是英文。想让 AI 用中文回复，得在设置里单独配。打开设置，搜 "cursor.chat"，找到语言相关的选项，设成中文。或者在对话的时候直接说"请用中文回复"，它也会照做。

4.2 在 Cursor 里配置自定义模型指向 MiniMax

Cursor 默认用的是自家的模型和 OpenAI 的模型，想让它走 MiniMax，得在设置里加自定义模型。打开 Cursor 设置，找到 "Models" 这一栏，里面有个 "Add Model" 的按钮。点进去之后，你需要填几个东西：模型名称、API Key、Base URL。

模型名称这里要注意，MiniMax 的兼容接口对模型名有要求。你不能随便填，得填 MiniMax 支持的模型标识。具体填什么，去 MiniMax 的 API 文档里查最新的模型列表。Base URL 填https://api.minimax.chat/v1，API Key 填你的 M Plan Key。

填完之后，Cursor 会做一个连接测试。如果测试通过，这个模型就会出现在模型选择列表里。你在写代码的时候，按Ctrl+K或者Ctrl+L调出 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 的过程中，报错是难免的。我把最常见的几个报错和解决方法整理成表，你遇到的时候直接对照查。

除了这些，还有一个隐蔽的问题：环境变量冲突。如果你之前配过 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 控制台里把它们归到同一个项目下。这样你既能单独监控每个工具的消耗，又能看到项目的总消耗，做成本分析的时候特别方便。这个设置花不了几分钟，但后面省的事不少。