2026/10/17 15:47:21

MiniMax-H3-Longvideos API 参考:H3 Long Videos 节点全部输入输出端口与参数速查

MiniMax-H3-Longvideos API 参考:H3 Long Videos 节点全部输入输出端口与参数速查 人工智能AI 应用媒体生成【免费下载链接】MiniMax-H3-Longvideos项目地址https://ai.gitcode.com/hf_mirrors/Smite79/MiniMax-H3-Longvideos点击查看免费下载本文是MiniMax-H3-Longvideos一个 ComfyUI 自定义节点包的完整 API 速查它能把一段文字提示词转换成MiniMax-H3 长视频 同步音频单镜头约 15 秒链式拼接可达约 120 秒。文章逐一列出H3 Long Videos主节点及其附带 3 个工具节点的全部输入端口、输出端口与参数默认值适合新手接线排错、也方便老手快速查参数无需再翻源码。 这个包提供哪 4 个节点MiniMax-H3-Longvideos 安装后在 ComfyUI 中注册 4 个节点入口定义见init.py节点显示名类名 / 注册键分类源码文件H3 Long VideosH3LongVideossampling/minimaxsampler.pyH3 Shot LengthH3ShotLengthMiniMax-H3/utilsshot_length.pyH3 Model InspectorH3ModelInspectorMiniMax-H3/multishotinspector.pyH3 OverlayH3OverlayMiniMax-H3/utilsoverlay.py 注意采样器在 sampler.py 只以H3LongVideos一个键注册但init.py 提到旧工作流使用的H3LongVideosFL2VA、H3LongVideosV1、H3LongVideosREF2VA名称均指向同一类老工作流可正常加载。 节点一H3 Long Videos核心采样节点输入输出声明位于 sampler.py共10 个必需输入 30 个可选输入 8 个输出。必需输入端口Required Inputs端口类型说明modelMODELMiniMax-H3 UNETfl2va/ref2va 混合模型效果最佳clipCLIPH3 文本编码器loader 类型选minimaxvaeVAEH3视频VAEaudio_vaeVAEH3音频VAE必须是转换后的版本promptSTRING多行强制输入第一段 场景拼接到每个镜头其后每段 一个镜头resolution下拉16:9 / 9:16 / 4:3 / 3:4 / 1:1 / 21:9 / 9:21默认16:9决定宽高比megapixelsFLOAT 0–2默认1.0H3 原生 1 MP 预算设0直接使用预设尺寸shot_secondsFLOAT 1–15默认10每个镜头的时长上限stepsINT 1–100默认8配 turbo/distill LoRA 用 6–8否则 20cfgFLOAT 1–20固定1.0——H3 是 CFG-free负提示词不会被评估sampler_name下拉默认res_multistep或配合 PDD Acc 用eulerscheduler下拉默认simpleseedINT支持生成后控制整条链共用一个种子可选输入端口Optional Inputs图像 / 条件类端口端口类型说明first_frameIMAGE钉住第 1 镜的首帧注意它会锁定整个构图人物定妆照请走ref_image_1ref_image_1~ref_image_4IMAGE身份参考图提示词里用Picture N标签可指定跟随哪个人/物negativeCONDITIONINGcfg1.0 时被忽略仅为接口完整sigmasSIGMAS外部采样计划如 PDD Acc 的 Apply 节点输出ambient_audioAUDIO环境音床覆盖输入留空则由场景自动合成数值 / 布尔开关类悬停均有 tooltip 说明端口默认值范围作用一句话shift_video12.01–20视频流 flow shiftshift_audio3.01–20音频流 flow shift与视频保持约 4:1apply_model_samplingTrue布尔节点内部修补双 schedule 开关silence_nonspeechTrue布尔无台词镜头把音频分支锚定到真实静音trim_seamTrue布尔去掉后续镜头首帧它是关键帧的重复ref_noise_aug0.9990.5–1.0参考图干净度调低可防背景/姿势被复刻tiled_decodeTrue布尔分块解码防显存溢出cleanup_between_shotsTrue布尔镜头之间清理显存latent_upscaleoff下拉latent 空间放大需另装 Upscaler 包latent_upscale_scale2.01–4latent 放大倍率upscaleoffoff/rtx/model/lanczos成片后的帧级放大后处理upscale_modelnone下拉upscalemodel时从 upscale_models 选择upscale_target_short_edge00–4096成片短边像素目标0 保持模型倍率upscale_batch41–64模型放大的每批帧数shot_lengthfrom the beat二选一from the beat按台词内容自适应镜头时长fixed统一为shot_secondsauto_removeTrue布尔从台词自动识别脱衣动作并同步更新角色状态restart_after_removalTrue布尔脱衣镜头后下一镜从头生成而非继承末帧hold_restraintsTrue布尔束缚道具一旦戴上后续每镜持续描述保持plan_onlyFalse布尔⭐ 只报告镜头切分、时长与警告不渲染建议每次先跑一遍anchor空STRING 多行全局镜头框架填写后提示词所有段落都视为 beatcharacter_memory空STRING 多行角色卡名字: 特征每行一人复印到每个镜头保持服装一致character_guardTrue布尔每镜只描述该 beat 涉及的人物pace1.00.25–2.0beat 时长缩放1 加快、1 放慢仅from the beat生效auto_soundTrue布尔为动作镜头生成动作音效hold_scene_stateTrue布尔门/窗等已描述状态固定在首帧mouths_shut_when_no_lineTrue布尔无台词镜头闭嘴代价放弃该镜手写的环境音hold_gazeTrue布尔让眼神落在台词指定的注视对象上ambient_level0.250–1环境音床响度0 关闭0.15–0.3 为宜foley_level0.350–1无台词镜头的动作拟音合成音量输出端口8 个RETURN 定义见 sampler.py输出类型用途imagesIMAGE成片帧序列 → 接 Video Combine / Save VideoaudioAUDIO同步音轨infoSTRING节点做了什么 全部警告出问题时必读scriptSTRING实际逐镜头发送给模型的文本frames_per_shotINT每镜帧数total_framesINT总帧数shotsINT镜头总数video_secondsFLOAT视频总时长秒最小接线示意来自 README.mdUNETLoader ─┐ images ─ Video Combine / Save Video CLIPLoader ─┼─ H3 Long Videos ─ audio ─┘ VAELoader ──┘ info ─ Show Text 节点二H3 Shot Length秒 ↔ 帧换算声明见 shot_length.py。H3 帧数必须落在17k5网格上且 ≤ 362 帧约 15 秒该节点把秒换算成合法帧数一次输入同时喂给采样器和预览节点。方向端口类型默认值输入shot_secondsFLOAT 0.2–15.15.0输入fpsINT 1–6024输入可选cap_to_h3_maxBOOLEANTrue钳制到 362 帧输出secondsFLOAT→ 采样器shot_seconds输出framesINT→ Model Preview Override输出infoSTRING换算说明文本 节点三H3 Model Inspector精度体检声明见 inspector.py。输入只需一个modelMODEL输出formatSTRING主导精度标签如BF16 / FP8 (e4m3) / NVFP4 / MXFP8 / INT8 convrot / W4A8等reportSTRING逐格式图层统计 你的显卡是否原生支持 NVFP4 / MXFP8 计算该节点OUTPUT_NODETrue会直接把报告渲染在画布上✍️ 节点四H3 Overlay水印 片头字幕声明见 overlay.py。它是纯合成节点应放在所有放大处理之后。方向端口默认值说明输入images—成品帧输入fps24仅用于把片头秒数换算成帧需与保存节点一致输入可选watermark_text空水印文字空 关闭输入可选watermark_positionbottom-right7 个位置可选输入可选watermark_size/opacity/margin4.0 / 0.75 / 3.0字号短边百分比/ 不透明度 / 边距输入可选intro_text空片头标题文字空 关闭输入可选intro_position/intro_seconds/intro_fadecenter / 3.0 / 0.6位置、保持时长、淡出时长输入可选intro_size/overlay_font/overlay_stroke9.0 / arial.ttf / 0片头字号、字体、描边粗细输出images—叠加后的帧输出info—执行备注如跳过原因✅ 推荐起步参数与常用资料新手最省心的组合cfg1.0、sampler_nameres_multistep、schedulersimple、shift_video12 / shift_audio3、megapixels1.0然后先开plan_only跑一遍读info确认镜头切分无误再正式渲染。提示词写法一段 一镜对话用双引号详见 README.md提示词解析引擎在 engine.py、镜头拆分逻辑在 sampler.py。现成演示工作流workflows/H3 LongVideos Demo Workflow.json导入即可对照本文各端口位置。安装方式把整个文件夹拷入ComfyUI/custom_nodes/后重启 ComfyUI服务器需 ComfyUI 0.31。⚠️ 小提示该节点组按位置恢复 widget 值。若面板出现 NaN右键节点 →Fix node (recreate)重新设值后再保存工作流见 README.md 的 Notes 一节。赞分享人工智能AI 应用媒体生成【免费下载链接】MiniMax-H3-Longvideos项目地址https://ai.gitcode.com/hf_mirrors/Smite79/MiniMax-H3-Longvideos点击查看免费下载相关推荐MiniMax-H3-Longvideos 参数速查表cfg / shift / steps / megapixels 等 10 个关键设置详解MiniMax H3 Longvideos 参数速查表cfg / shift / steps / megapixels 等 10 个关键设置详解 MiniMa人工智能AI 应用媒体生成MiniMax-H3-Longvideos 架构全景4 个 ComfyUI 节点与 6 个源码文件深度剖析MiniMax H3 Longvideos 架构全景4 个 ComfyUI 节点与 6 个源码文件深度剖析 MiniMax H3 Longvideos 是一个人工智能AI 应用媒体生成给 AI 长视频加水印和片头MiniMax-H3-Longvideos 的 H3 Overlay 文字叠加节点使用教程给 AI 长视频加水印和片头MiniMax H3 Longvideos 的 H3 Overlay 文字叠加节点使用教程 MiniMax H3 Longvide人工智能AI 应用媒体生成创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考