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 支持参考图输入这在实际项目中非常有用——你有一张角色设定图希望视频里出现同一个角色这时候就需要参考图来锁定角色一致性。我的操作套路是准备一到两张参考图。第一张负责锁定主体特征比如角色全身像第二张可以用于风格定调比如色彩氛围参考。参考图分辨率建议不低于 1024模糊图会导致角色漂移。在分镜脚本里显式标记保持主体与参考图一致。别指望模型自动理解你需要把一致性要求写进 prompt。10 秒视频建议拆成 2 到 3 个分镜每个分镜用独立段落描述。分镜之间可以加时间提示比如镜头一0-3秒…… 镜头二3-7秒…… 镜头三7-10秒……这样模型对节奏的把握会更准确。实测下来H3 对主角一致性的表现已经可以商用但如果角色有大幅度转身、换装仍可能出现细节变形。重要素材生成后务必逐帧检查不要直接上生产。3. Claude Code 免密接入 MiniMaxAPI 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_BASE_URL指定 Anthropic 兼容端点https://api.minimaxi.com/anthropicANTHROPIC_AUTH_TOKEN设置 API Key 鉴权你的 MiniMax API KeyANTHROPIC_MODEL主模型MiniMax-M2ANTHROPIC_SMALL_FAST_MODEL轻量快模型MiniMax-M1ANTHROPIC_SMALL_FAST_MODEL主要用于代码补全、简单问答这些低延迟场景建议单独指定一个更轻的模型这样主模型和快模型的负载能分开响应速度体验更好。3.2 Linux / macOS / Windows 配置步骤以我常用的 macOS 为例在 shell 配置文件~/.zshrc或~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://api.minimaxi.com/anthropic export ANTHROPIC_AUTH_TOKEN你的MiniMax_API_Key export ANTHROPIC_MODELMiniMax-M2 export ANTHROPIC_SMALL_FAST_MODELMiniMax-M1保存后执行source ~/.zshrc让环境变量生效然后直接启动claudeWindows 用户用 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 兼容端点填进去。操作步骤如下打开 Cursor 的 Settings找到 Models 区域。选择添加自定义模型Add Model。提供商选择 OpenAI Compatible 或类似选项。Base URL 填https://api.minimaxi.com/v1API Key 填你的 MiniMax API Key模型 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 启动时自动加载这样换电脑、同步配置的时候都不用担心密钥泄露。工具会迭代但把密钥管好、把端点配对这个基本功什么时候都不过时。