Nodes/ComfyUI-MiniMaxH3-Myang/沐阳 H3 · 长视频(原生多关键帧)
ComfyUI Node

沐阳 H3 · 长视频(原生多关键帧)

One node that expands into a whole multi-segment sampling chain

By civilcoco·Created 3 days ago·Updated 3 days ago· 1
沐阳 H3 · 长视频(原生多关键帧)
  • h3
  • model
  • sampler
  • ref_video
  • ref_audio
  • media
  • 二采设置
  • context_video
  • context_audio
  • images
  • audio
plan_json
task_mode动作迁移(跟随参考视频)
resolution480P
aspect_ratio16:9
width1344
height768
steps8
denoise1.00
schedulersimple
noise_seed0
context_length22
prompt_mode直接用分段稿
media_prefix参考@视频1中的人物动作表情、镜头角度、画面风格,仅将人物替换成@图片1。
legacy_plan_padding
ref_image_size匹配生成分辨率
save_segmentstrue
segment_prefixvideo/H3_长视频
save_raw_segmentsfalse

沐阳 H3 · 长视频(原生多关键帧) (H3LongVideo) is where the pack earns its "long-video workflow" headline. It's one node that, at runtime, expands into N sampling chains - one per segment - stitching them together with the anchor mechanism you'd otherwise wire by hand: carry the tail of each segment into the head of the next, sample, trim the overlap, move on. If 沐阳 H3 加载器 is the entry point and the Director is the all-in-one, this is the manually-wired graph's engine, and it's also what the Director delegates to internally.

The critical input is plan_json, and the tooltip hammers the point: it's a segment plan (how many segments, how many frames each, how much they overlap), not a prompt. You get it from a splitter like H3ScriptSplitter, and the number that matters most is the overlap, because context_length here must match the plan's overlap_frames exactly. Get those out of sync and your seams stop being seamless - that mismatch is probably the single most common LongVideo bug.

The settings that actually matter

  • task_mode - 动作迁移 (motion transfer, default): each segment follows the corresponding slice of the reference video. 视频续写 (continuation): only the reference video's ending is used as the starting point, and picture and sound pick up from there. 纯生成 (pure generation): no reference video, prompt and images only.
  • context_length - 22 is the stable default; 5 is the experimental speed anchor; 39/56 for stronger continuity at higher token cost. Must match plan overlap.
  • ref_image_size - the reference budget. "匹配生成分辨率" is the memory-cheap default; the max-fidelity 2048 short-edge option makes every reference token more expensive every step, and the tooltip warns it's "several times slower."
  • save_segments / segment_prefix / save_raw_segments - per-segment saving. Long runs die at hour three sometimes; saved segments mean you can resume and only re-run what broke. save_raw_segments additionally keeps the pre-second-pass segments (suffixed _原始) when you want to A/B against the refined output.
  • prompt_mode / media_prefix - when the prompt box is empty, each segment uses its plan brief, prefixed with the media-reference line so @视频1 style mentions keep working.

Optional inputs do the important work: ref_video (motion transfer needs it long enough to slice one piece per segment; continuation only reads its ending), ref_audio (continuation's sound picks up from the reference's ending), media from the Media Agent (the whole-job media bundle), 二采设置 (the second-pass settings bundle), and context_video/context_audio for resume - a previous segment's finished clip whose tail only seeds the first segment's anchor, never the ref2va reference channel.

Outputs: images and audio, the assembled long take.

Install and ground rules

Install via ComfyUI Manager search "ComfyUI-MiniMaxH3-Myang", or git clone https://github.com/civilcoco/ComfyUI-MiniMaxH3-Myang into custom_nodes, restart, hard-refresh. No extra Python deps; supply the H3 model, text encoder and both VAEs yourself.

The README's procedure is the right one: render two segments with a 22-frame context first, inspect picture, motion, lip-sync and audio at the join, and only then crank up the segment count or add Turbo/second-pass. Long chains accumulate losses in detail, timbre, brightness and saturation - a clean seam doesn't guarantee a clean chain. And the pack's compatibility caveat: it's regression-tested against ComfyUI v0.33.2/v0.34.0 layouts, so after any ComfyUI update, validate a two-segment render before committing to a long job.

Category沐阳 H3

Inputs (27)

NameTypeDefaultDescription
h3MYANG_H3接「沐阳 H3 加载器」
modelMODEL
samplerSAMPLER
plan_jsonSTRING分段计划:段数 / 每段帧数 / 重叠。不是提示词。
task_modeCOMBO动作迁移(跟随参考视频)动作迁移:每段跟随参考视频对应的那一片。视频续写:只取参考视频的结尾作为起点,接着往下演,画面和声音都从那里无缝接上。纯生成:不用参考视频,全靠提示词和图片。
resolutionCOMBO480P12 options: 360P, 416P, 480P, 540P, 640P, 720P, +6
aspect_ratioCOMBO16:98 options: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, +2
widthINT134432–16384
heightINT76832–16384
stepsINT81–200
denoiseFLOAT1.000–1
schedulerCOMBOsimple9 options: simple, normal, karras, exponential, sgm_uniform, ddim_uniform, +3
noise_seedINT00–18446744073709550000
context_lengthCOMBO22必须与分段 overlap_frames 一致。22=稳定基线;5=实验速度锚点;39/56=更长连续窗
prompt_modeCOMBO直接用分段稿只在 prompt 框留空时生效:逐段用 plan_json 的分段稿
media_prefixSTRING参考@视频1中的人物动作表情、镜头角度、画面风格,仅将人物替换成@图片1。只在走分段稿时用:每段提示词前面原样加上这句媒体引用
legacy_plan_paddingSTRING旧工作流迁移占位;不参与提示词、LLM 或采样。
ref_image_sizeCOMBO匹配生成分辨率参考素材怎么缩放。匹配生成分辨率最省显存;最大保真走 2048 短边,画面更像但每一步都要带着它算,慢好几倍
save_segmentsBOOLEANtrue每段单独存一份。长片跑到一半崩了还能接着用,也方便挑出想重跑的那一段
segment_prefixSTRINGvideo/H3_长视频
save_raw_segmentsBOOLEANfalse开启二采时,额外保存二采前的原始分段(已裁掉锚点帧),文件名追加 _原始,便于和二采后的成片对比。未开二采时此项无效。
ref_videooptIMAGE动作迁移要它够长(每段切一片);续写只用它的结尾;纯生成不用接
ref_audiooptAUDIO续写时接上,声音也从参考视频的结尾接着走
mediaoptMINIMAX_H3_MEDIA接 MiniMaxH3MediaAgent 的 media 输出。全片素材都从这里来;循环只把包里那条参考视频换成本段切片,编号不变。
二采设置optMYANG_H3_DETAIL接『沐阳 H3 · 二采放大设置』;二采开关和所有参数都由它管理
context_videooptIMAGE断点续跑:上一段已生成的成片。只取它的结尾做首段锚点,不进入 ref2va 参考视频通道
context_audiooptAUDIO可选:与 context_video 配套的音轨,用于声音接缝

Outputs (2)

NameTypeDescription
imagesIMAGE
audioAUDIO