MiniMax M Plan全模态额度实测：H3视频生成与Claude Code/Cursor接入指南

MiniMax 这波动作够直接的——Token Plan 说退就退，M Plan 接棒，全模态额度大一统，H3 视频模型也解禁了。我这两天把 Claude Code 和 Cursor 都接到了 MiniMax 的 API 上，实测下来流程比想象中顺，尤其是"免密"配置这块，一次性把环境变量写对，后面就再也不用碰账号登录那套东西了。这篇就完整记录一下我的操作过程，从 M Plan 的额度变化、H3 视频生成的分镜写法，到 Claude Code 和 Cursor 的具体接入步骤，最后补上本地部署 H3 的显存优化经验。适合正在观望要不要切 M Plan、或者想把 MiniMax 模型接进日常编码工作流的朋友参考。

1. M Plan 到底改了什么：从"Token Plan"到全模态额度大一统

1.1 额度计费方式的变化，比想象中影响更大

先说结论：M Plan 最核心的变化，是把过去分散的计费通道合并成了一个统一的额度池。

以前的 Token Plan，文本按 token 消耗计费，视频按条扣费，图像和音频又有各自独立的计量口径。虽然 API 层面都是走同一个平台，但实际使用中特别别扭——你永远得心里装着"这个项目剩多少文本额度，那次视频生成会不会直接把余额干穿"。尤其是我这种既写代码又偶尔生成视频素材的人，经常要开两个控制台页面来回核对剩余量。

M Plan 的设计思路则是"全模态额度大一统"：文本、图像、音频、视频全部从同一个额度池里扣。打个比方，以前是三块水表各充各的钱，现在是一个总水表，水龙头一开，所有设备共享同一份水量。这样做的好处很直接：你不需要再预估"这个月视频要占多少比例、文本要占多少"，只要总额度足够，任何一种模态都可以随时用。

对于重度用户来说，这种模式还有一个隐藏优势——额度利用率更高。过去如果视频额度用不完、文本额度不够花，就会出现"钱花了但没花在刀刃上"的情况。统一额度池之后，哪边需求大，额度就自动倾斜到哪边，理论上不会出现"某类额度年底清零"的尴尬。

1.2 H3 视频解禁，补上了最后一块拼图

M Plan 里另一个值得关注的点，是 H3 视频模型的解禁。H3 是 MiniMax 的视频生成模型，支持生成 5 秒和 10 秒短视频。以前它在套餐里的可用性比较受限，要么需要单独开通、要么走单独的计费通道，反正我在 Token Plan 时代基本没敢放开用。M Plan 上线后，H3 直接走统一额度，等于把视频生成能力正式放进了日常工具的范畴。

我实测的体感是，H3 输出质量对付"短视频素材、分镜预览、产品演示片段"这类需求完全够用。而且解禁之后可以连续生成多段素材，不用像以前那样每生成一条都要反复确认额度，效率提升非常明显。

1.3 老用户怎么平滑切换

如果你之前用的是 Token Plan，登录 MiniMax 开放平台之后，大概率会看到套餐页面的自动迁移提示。我的建议是：

• 先别急着重新创建 API Key，旧的 Key 在迁移后通常可以继续用，系统会自动绑定到新的 M Plan 额度池。
• 确认迁移时点。如果你的 Token Plan 还有剩余额度，注意看控制台里有没有"剩余 Token 折算"或"有效期顺延"的说明，避免旧余额白白丢掉。
• 切换完成后，用任意一个现有 Key 调一次接口，确认额度池里的数字能正常扣减。

实操里我遇到过一个小坑：自动迁移后，控制台显示的"剩余额度"需要几分钟才刷新。如果你刚切完就调用接口，看到额度没变化别慌，稍等一会儿再看。

2. H3 视频生成实测：5 秒短视频的提示词与分镜脚本写法

2.1 一次完整的 H3 视频生成调用

H3 的 API 调用逻辑不复杂，先提交生成任务，再轮询任务状态拿结果。一个标准的 5 秒视频生成请求长这样：

curl -X POST "https://api.minimaxi.com/v1/video_generation" \ -H "Authorization: Bearer $MINIMAX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "MiniMax-H3", "prompt": "一只橘猫在雨夜小巷的纸箱里探头，警惕地看向镜头，雨水打湿毛发，霓虹灯光反射在湿漉漉的青石板上，镜头从50mm中景缓慢推近，氛围静谧而紧张", "duration": 5, "resolution": "1280x720" }'

提交成功后，接口会返回一个task_id，拿这个 ID 去查任务状态：

curl -X GET "https://api.minimaxi.com/v1/video_generation/result?task_id=你的task_id" \ -H "Authorization: Bearer $MINIMAX_API_KEY"

视频生成一般需要几十秒到几分钟不等，具体取决于分辨率、时长和当前排队情况。如果你的场景是批量生成，记得做任务队列管理，别把调用写成同步阻塞模式，否则生成 10 条视频就得干等 10 次。

2.2 5 秒视频提示词该写多少字、怎么写

热词榜里有人问"H3 生成 5 秒视频提示词需要多少字"，我直接说结论：不需要写太多，50 到 120 字是甜点区间。

5 秒视频大概对应 75 到 150 帧，能承载的信息量非常有限。你把一个场景写清楚，让模型知道"主体是谁、在做什么、环境什么样、光线如何、镜头怎么动"，就足够了。堆太多细节进去，反而容易让模型在有限帧数里手忙脚乱，出现主体漂移或动作不连贯。

我整理了一个通用的提示词结构，按这个模板写基本不会翻车：

• 主体：谁出场，主要特征是什么（橘猫、穿红色连衣裙的女孩、一辆银色跑车）
• 动作：主体在做什么，动作要具体（探头、转身、加速驶过）
• 场景：环境信息（雨夜小巷、老式咖啡馆、赛博朋克风格街道）
• 光线：光源和氛围（霓虹灯光、黄昏逆光、柔和的室内暖光）
• 运镜：镜头怎么动（缓慢推近、从下往上摇、跟随平移）
• 氛围：整体情绪基调（静谧、紧张、温馨、荒诞）

照这个模板拼出来的提示词，基本不会出现"模型不知道你想干嘛"的情况。

2.3 参考生视频：分镜脚本怎么和参考图配合

H3 支持参考图输入，这在实际项目中非常有用——你有一张角色设定图，希望视频里出现同一个角色，这时候就需要参考图来锁定角色一致性。

我的操作套路是：

1. 准备一到两张参考图。第一张负责锁定主体特征（比如角色全身像），第二张可以用于风格定调（比如色彩氛围参考）。参考图分辨率建议不低于 1024，模糊图会导致角色漂移。
2. 在分镜脚本里显式标记"保持主体与参考图一致"。别指望模型自动理解，你需要把一致性要求写进 prompt。
3. 10 秒视频建议拆成 2 到 3 个分镜，每个分镜用独立段落描述。分镜之间可以加时间提示，比如"镜头一：0-3秒…… 镜头二：3-7秒…… 镜头三：7-10秒……"，这样模型对节奏的把握会更准确。

实测下来，H3 对"主角一致性"的表现已经可以商用，但如果角色有大幅度转身、换装，仍可能出现细节变形。重要素材生成后务必逐帧检查，不要直接上生产。

3. Claude Code 免密接入 MiniMax：API Key 一次配置，永不再输账号

3.1 免密的原理：API Key 与 Anthropic 兼容端点

很多人第一次听说"免密打通 Claude Code"会以为是绕过官方订阅，其实不是。这里的"免密"指的是：用 API Key 代替 Claude 账号的交互式登录。

Claude Code 默认是绑定 Claude 账号的，启动时会引导你登录账号，走订阅或官方 API 计费。但 Claude Code 也支持通过环境变量指定自定义的 Anthropic 兼容端点。MiniMax 开放平台提供了这个兼容端点，你把环境变量指过去，Claude Code 就会把请求发给 MiniMax，用 MiniMax 的 API Key 鉴权，模型自然也就换成了 MiniMax 侧的模型。

整个流程中你不需要输入任何 Claude 账号密码，这就是"免密"的本质。从体验上讲，配置一次之后，每次启动claude都是直接可用，非常干净。

核心环境变量就四个：

ANTHROPIC_SMALL_FAST_MODEL主要用于代码补全、简单问答这些低延迟场景，建议单独指定一个更轻的模型，这样主模型和快模型的负载能分开，响应速度体验更好。

3.2 Linux / macOS / Windows 配置步骤

以我常用的 macOS 为例，在 shell 配置文件（~/.zshrc或~/.bashrc）里加上：

export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic" export ANTHROPIC_AUTH_TOKEN="你的MiniMax_API_Key" export ANTHROPIC_MODEL="MiniMax-M2" export ANTHROPIC_SMALL_FAST_MODEL="MiniMax-M1"

保存后执行source ~/.zshrc让环境变量生效，然后直接启动：

claude

Windows 用户用 PowerShell 配置：

$env:ANTHROPIC_BASE_URL = "https://api.minimaxi.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN = "你的MiniMax_API_Key" $env:ANTHROPIC_MODEL = "MiniMax-M2" $env:ANTHROPIC_SMALL_FAST_MODEL = "MiniMax-M1"

验证是否配置成功，最简单的办法是启动后问一句"你现在用的是哪个模型"。如果回答里包含 MiniMax 相关字样，说明请求已经走通了。也可以用命令行直接跑一个非交互式测试：

claude -p "你是哪个模型，一句话回答"

如果返回正常，说明免密通道已经打通。

3.3 常见报错与排查

我在配置过程中遇到过几个报错，直接给你们排雷：

报错一："your organization has disabled Claude subscription access for Claude Code"

这个报错特别容易让人懵，第一反应以为是账号出问题了。其实它说明请求走了 Claude 的订阅通道，而不是你设置的 API 通道。常见原因是环境变量没生效，或者存在残留的 Claude 登录态。解决办法：

• 确认echo $ANTHROPIC_BASE_URL能输出你设置的值
• 删除~/.claude下的旧登录缓存文件
• 新开一个终端窗口再启动，避免 shell 缓存旧环境

报错二："401 authentication_error"

这是鉴权失败，大概率是 API Key 写错了，或者 Key 里有多余的空格。另外注意，MiniMax 的 API Key 区分大小写，粘贴的时候别让编辑器自动转成小写。

报错三：模型名称不合法

ANTHROPIC_MODEL填的模型名必须以 MiniMax 侧实际存在的模型名为准。你可以先去开放平台的模型列表里确认当前的模型标识，不要照搬我文章里的MiniMax-M2或MiniMax-M1，以你账号下实际可用的为准。

关于 cc switch 这类工具

社区里有一些模型切换工具（比如 cc switch），可以把 DeepSeek、Qwen、GLM 等模型的接入流程进一步简化。本质就是帮你自动改环境变量，免去手动编辑 shell 配置。如果你经常在多个模型之间切换，确实值得用；如果只是像我一样固定用 MiniMax，手写环境变量更省事，没必要多引一个工具。

4. Cursor 接入 MiniMax：模型配置、中文界面与日常使用

4.1 Cursor 自定义模型入口与 OpenAI 兼容端点

Cursor 接入 MiniMax 的原理跟 Claude Code 不太一样。Cursor 官方支持自定义模型，走的是 OpenAI 兼容协议，所以你需要把 MiniMax 的 OpenAI 兼容端点填进去。

操作步骤如下：

1. 打开 Cursor 的 Settings，找到 Models 区域。
2. 选择添加自定义模型（Add Model）。
3. 提供商选择 OpenAI Compatible 或类似选项。
4. Base URL 填：https://api.minimaxi.com/v1
5. API Key 填：你的 MiniMax API Key
6. 模型 ID 填：MiniMax-M2（或者你在开放平台看到的最新文本模型 ID）

配置完成后，在模型选择器里把 MiniMax 模型设为默认即可。这样你在 Cursor 里的对话、代码生成、内联补全，都会走 MiniMax 的 M Plan 额度。

需要特别提醒的是：Cursor 自带的免费额度只适用于 Cursor 官方的模型。你把 MiniMax 模型接进来之后，这部分请求是直接打到 MiniMax 的，扣的是 M Plan 的额度，别指望它用 Cursor 的免费额度。

4.2 中文界面与中文回复设置

热词榜里有一大批关于"Cursor 中文设置"的问题，正好在这篇里一并解决。

Cursor 的中文界面设置很简单：Settings 里搜索 Language，选择 Simplified Chinese，重启生效。不用装汉化插件，官方自带的就是最稳的。网上那些汉化包很多时候只覆盖了菜单文本，遇到专业英文术语反而翻译得很奇怪，不值得折腾。

但"中文界面"和"中文回复"是两件事。如果你希望 Cursor 里的模型用中文回答，动手脚的地方在提示词，不在界面设置。我在用 MiniMax 模型时会特别在 System Prompt 里加一句"始终使用简体中文回复，不要用英文"，这样不管我输入什么，模型输出都保持中文，比在界面里找语言设置高效得多。

4.3 代码跳转能力：和 Source Insight 的对比

有个热搜词问"Cursor 可以像 Source Insight 一样跳转代码块吗"，我在这里说一下实际体验。

Source Insight 是老牌代码阅读神器，它的符号跳转、全局定义浏览、交叉引用高亮在嵌入式、C/C++ 这种老派项目里体验极佳。Cursor 作为 AI 编辑器，跳转逻辑不太一样，但能力并不差：

• Cmd + 点击：跳转到函数定义，最常用的基本操作
• Ctrl + Shift + F：全项目搜索符号
• /index索引项目后，可以用自然语言进行语义级跳转，比如问"这个按钮点击后调用的最终处理函数在哪"

我接上 MiniMax 模型后，最明显的感受是语义跳转更聪明了。长上下文模型能把跨文件的调用链读得更透，回答"这个变量在哪被修改过"之类的问题，准确率明显高于我过去用的小模型。

但要说完全替代 Source Insight，也不现实。老牌 IDE 那种宏定义自动展开、所有交叉引用一次性列出、局部变量高亮的细粒度体验，AI 编辑器还有距离。我的策略是：老项目的 code review 用 Source Insight，新项目开发和 AI 辅助用 Cursor，两者不冲突。

4.4 Cursor 注册与免费额度补充

有几个热搜词是关于 Cursor 注册的，顺带补一句。注册的时候优先用邮箱，手机号验证在部分场景下有延迟，尤其是 +86 号段。如果系统要求填手机号，注意国家区号要选对，不然验证码永远收不到。首次注册会送一些免费额度，用于 Cursor 官方模型；免费额度用完后，要么订阅 Cursor 套餐，要么像我一样接 MiniMax 的 M Plan，走自己的 API Key。

5. 本地部署 H3 与显存优化的硬核补充

5.1 云端 API 与本地部署怎么选

M Plan 走的是云端 API，本地一分钱显存不费。但热词里冒出来一堆"ollama 安装""本地部署 minimax"的搜索，说明很多人想在本地跑 H3。我的建议分两种情况：

• 图省事、快速出成果：直接用云端 API。M Plan 解禁后，视频生成不再需要单独处理计费问题，这是效率最高的路径。
• 有私有化需求、批量测试、不想走网络：才考虑本地部署。H3 这种视频生成模型的显存需求不小。以我实际跑过的经验，70B 级别的量化权重启动就得 48GB 显存起步，想要长视频生成更从容，80GB 级别是稳妥选项。显存不够的机器，可以开 mem eff（内存高效模式），以生成速度换显存占用，但别指望体验和云端一致。

5.2 Ollama 与 ComfyUI 工作流

有人问"ComfyUI 跟 H3 模型怎么结合"。目前社区确实有一些尝试，但还没有一个像 Stable Diffusion 那么成熟的官方节点。如果你非要在 ComfyUI 里跑 H3，注意两点：一是模型路径要指到 H3 权重实际存放的位置，二是显存管理模式要提前配置好，不然首帧生成时经常爆显存。我的个人态度是，ComfyUI 生态对视频生成模型的适配还没有稳定到"开箱即用"的程度，等社区再沉淀一段时间更稳妥。

Ollama 的玩法倒是可以直接套用。你可以在本地用 Ollama 部署一个模型权重，然后通过 OpenAI 兼容接口暴露给 Cursor 或 Claude Code。本质上跟配置 MiniMax 云端端点是同一套逻辑，只是把 Base URL 换成http://localhost:11434/v1这类本地地址。Claude Code 调用 LM Studio 本地模型也是同理，设置环境变量指向http://localhost:1234/v1即可。

5.3 显存占用率与生成速度的调优经验

热搜词里有一条特别有意思："提高 minimax h3 显存占用率"。

一般情况下大家都在想"怎么降低显存占用"，想让显存占用率提高，说明你遇到了反直觉的情况：显存占用不高，生成速度却上不去。我也是后来才调试明白，这在推理场景里并不少见——显存占用低，往往意味着算力单元没有跑满，算子调度有气泡。

拿nvidia-smi盯显存，如果占用长期低于 60% 且生成速度不理想，可以尝试：

• 增大单次请求的 batch size，把更多的 token/帧放进一次推理，把显存占用顶上去，吞吐量反而会明显提升。
• 检查是否开启了 mem eff。内存高效模式本质是拿时间换空间，如果你显存明明够用，却开了 mem eff，那就是白白牺牲速度。
• 确认算子是否完整。国产加速卡（比如海光 K100 这类平台）跑 H3 时，速度和显存利用率高度依赖驱动和算子适配。有用户实测反馈，ROCm 环境需要额外调优才能跑满，建议先跑官方示例脚本验证算子的完整性，再上批量任务。

最后一条经验：如果你不是专门做模型研究的，H3 用云端 API 是绝对省心的选择。本地部署看起来自由，但视频生成模型的硬件要求和调优成本，真不是一两块民用显卡能兜住的。

这次 M Plan 切换，我最直观的感受就是省心。以前文本、视频、图像各自惦记占比，现在一个额度池全包，Claude Code 和 Cursor 也都接到了同一个 MiniMax Key 上。最后分享一个小技巧：别把 API Key 明文写在 shell 配置里，用本机的密钥管理器或者独立的 env 文件管理，Claude Code 启动时自动加载，这样换电脑、同步配置的时候都不用担心密钥泄露。工具会迭代，但"把密钥管好、把端点配对"这个基本功，什么时候都不过时。