MiniMax H3 的提示词优化,什么时候值得打开?
MiniMax H3 的 prompt_optimizer 默认关闭,开启后先处理提示词再生成。用同一场景对照两次,检查改写有没有带走必须保留的镜头约束。

如果你只写了“拍一段安静的产品短片”,可以试试让 MiniMax H3 先优化提示词;如果提示词已经是审核过的镜头单,先保留关闭。prompt_optimizer 多做了一道文字处理,不能把「镜头不动」「不加字幕」变成硬性保证。
开关影响的是哪一步?
Nbility 的 MiniMax H3 接口接收 JSON 布尔字段 prompt_optimizer。省略或填 false 不启用这个优化步骤,填 true 则先将提示词处理成 H3 适用的格式,再提交生成。这项能力目前处于内测,只有开通的线路可用。不要传字符串 "true",也不要把字段写成 prompt_optimize。
这和 MiniMax 官方 V2 的 H3-Context-IR 不是一个接口。后者创建单独的任务,成功后在查询结果的 content.prompt 读取增强提示词,不返回成片。需要在花时间生成之前人工审阅改写内容,可以研究官方这条分步路径;不要把官方端点拼到 Nbility 地址上,也不要假定本站开关会把中间稿返回给你。后续要走官方 H3 2K 再生成时,最终送入模型的提示词还可能是必须保留的输入。
怎么看优化是在帮忙,还是擅自加戏?
用一段五秒、内容简单的公开场景,给两个版本同一份镜头单。以下是可放入 POST /v1/videos 请求的基线 JSON;true 版只改动最后一个字段。
{
"model": "MiniMax-H3",
"prompt": "固定近景,白色桌面。手从右侧把一只无字陶瓷杯放到画面中间后离开。保持杯子形状和颜色。不要字幕,不要切镜头。",
"resolution": "768P",
"duration": 5,
"ratio": "16:9",
"prompt_optimizer": false
}
先看硬条件:桌面有没有越拍越近?手是不是从右侧进入?杯子形状是否变化?有没有多出字幕或切镜?硬条件过了,再谈灯光好不好看、停顿顺不顺。两次生成可能随机波动;一对样片可以挑一条更合适的,不能证明某个档位总是更好。正式采用前,再挑几条实际会做的镜头重复对照,不要同时换提示词或参考图。
哪些记录能帮你决定下次开不开?
保存原稿、开关值、素材版本、输入参数、任务号,以及哪条约束没通过。如果两次都发生主体漂移,先缩短连续动作,把颜色和机位写具体,或提供自己有权使用的参考图。优化并不能替你决定是要照着一段动作拍,还是沿着原片继续拍。
接口退回字段错误时先查类型与线路;拿到任务号以后就按视频任务查询和恢复流程继续,不因暂时没看见成片就重复提交。本文于 2026 年 11 月 20 日核对本站文档与 MiniMax 官方 V2 创建参考,只检查了请求结构,没有调用模型,也没有量过优化前后的质量或等待时间。


