Nodes/MiniMax H3 Audio T8/MiniMax H3 Motion Segment Plan / 动作分段窗口计划 (Advanced)
ComfyUI Node

MiniMax H3 Motion Segment Plan / 动作分段窗口计划 (Advanced)

Slice one repair plan into VRAM-sized windows instead of one giant pass

By T8mars·Created 20 days ago·Updated a day ago· 807
MiniMax H3 Motion Segment Plan / 动作分段窗口计划 (Advanced)
  • frames
  • baseline_audio
  • motion_plan
  • segment_frames
  • window_plan
  • first_frame
  • last_frame
  • segment_audio
  • window_count
  • window_index
  • report_json
max_expanded_frames209
window_index0
handle_frames12
coveragehot_ranges_only

A full-clip motion repair pass on a 124-frame H3 render is one big, expensive joint AV sample - great on a big card, a gamble on 16GB. MiniMaxH3MotionSegmentPlanT8Advanced exists to turn that one monolithic repair into a sequence of budgeted windows you can render one at a time. It takes your signed full-clip motion plan and chops it into sequential, budgeted windows, each small enough that a single window's second pass stays inside your VRAM envelope.

The honest part is in the description: it does not impose a global pixel/frame prohibition on you. If the motion plan's hot ranges are too many or too hot for your budget, it reports the hot cuts so you can decide - raise the budget, lower max_hold, or accept the cost. It's a budgeting tool with good manners, not a nanny.

Inputs

  • frames and baseline_audio - the pass-1 material the windows are cut from.
  • motion_plan - the signed full-clip plan from the analyzer; this is what gets windowed.
  • max_expanded_frames (209) - the budget per window in expanded frames. 209 is the default because it's a plausible H3-grid-friendly chunk; lower it if you're tight on VRAM.
  • window_index - which window you're producing (0..999). You drive the loop yourself, rendering each window sequentially.
  • handle_frames (12) - overlap/handle frames between windows so the seams don't pop.
  • coverage - hot_ranges_only by default (only the flagged motion ranges get repaired); the other option is full coverage.

Outputs

segment_frames - the window's frames, ready for the retiming/prepare step. window_plan - a signed per-window plan. first_frame / last_frame - window anchors. segment_audio - the matching audio slice. window_count - how many windows the full plan broke into. window_index, and report_json.

Install and where it fits

Pack install once: ComfyUI Manager → search MiniMax H3 Audio T8, or git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8 into ComfyUI/custom_nodes/, restart. No pip extras, no model downloads.

Chain position: OverloadAnalyze → MotionSegmentPlan → (per window) RetimingPrepare → RecoveryComposer → RecoverAV → MotionWindowCollect. The workflow pattern is: read window_count, then run the window loop N times with increasing window_index, feeding each result into the Window Collect node. Where people stumble is expecting this node to run the loop for them - it doesn't. It produces the windows and the plan; the loop is yours (the pack's example workflows show the wiring). And if window_count comes back bigger than your patience, that's the signal to raise max_expanded_frames or tune the analyzer's max_hold down. It's Experimental, so budget for a test pass before trusting the seams.

CategoryT8/MiniMax H3/Quality/Experimental/Motion Recovery

Inputs (7)

NameTypeDefaultDescription
framesIMAGE
baseline_audioAUDIO
motion_planH3_T8_MOTION_RECOVERY_PLAN
max_expanded_framesINT20939–10000
window_indexINT00–999
handle_framesINT122–48
coverageCOMBOhot_ranges_only2 options: hot_ranges_only, full_clip

Outputs (8)

NameTypeDescription
segment_framesIMAGE
window_planH3_T8_MOTION_RECOVERY_PLAN
first_frameIMAGE
last_frameIMAGE
segment_audioAUDIO
window_countINT
window_indexINT
report_jsonSTRING