ComfyUI Node
H3MD Loop Sampler
Runs all segments of an H3MD plan (same computation as the legacy H3MD Loop Sampler). Advanced switches: connect H3MD Loop Options; semantic bridges: connect H3MD Semantic Bridge. Outputs: only 'long video' -> H3MD Save Video Interp is designed to stay within bounded VRAM/RAM (it streams chunk by chunk from the disk cache). 'latent' (the joined audio-video latent) and 'audio' (the joined audio) can also be connected to other nodes for upscaling / custom processing, e.g. Separate AV Latent -> Hyper-VAE or a VAE decoder -> VHS Video Combine. 'images' is only a 64x64 placeholder (merge_images was removed): to get frames, decode 'latent' externally. WARNING: for large / long videos the latent / decoded-image / audio paths do NOT guarantee against VRAM/RAM blowups - decoding the full latent externally holds the whole clip in memory. 输出说明：只有 'long video' → H3MD Save Video Interp 是按有限显存/内存设计的（从磁盘缓存一段一段流式处理）。'latent'（拼好的音视频 latent）和 'audio'（拼好的音频）也可以接到别的节点做放大或自定义处理，例如 Separate AV Latent → Hyper-VAE 或 VAE 解码器 → VHS Video Combine。'images' 只是 64x64 占位图（merge_images 已删除）：要拿到画面帧，请在外部解码 'latent'。警告：大/长视频走 latent / 解码图片 / audio 这些路径不保证显存/内存不爆——在外部解码整段 latent 会把整段视频放进内存。
H3MD Loop Sampler
- plan
- clip
- vae
- audio_vae
- low_res_model
- sampler
- sigmas
- high_res_model
- semantic_bridge
- options
- depth_control
- latent
- images
- audio
- frame_count
- summary
- long video
◄rerun_segments►
◄stop_after0►
◄rerun_new_seedtrue►
◄seed0►
◄cfg1.0►
◄transition_step6►
◄lowres_scale0.50►
◄rho0.00►
◄w_min0.50►
◄w_max1.00►
◄upscaler_modelnone►
◄seed_modeincrement►
◄decode_outputtrue►
◄highres_tilingtrue►
◄cache_modedisk►
◄delete_cachetrue►
◄resume_from_cachefalse►
CategoryMiniMax H3/H3MD
Inputs (28)
| Name | Type | Default | Description |
|---|---|---|---|
| rerun_segments | STRING | Re-render only these segments (1-based, as in the log): e.g. 3 or 4-6 or 8-10, 13-14. Empty = normal run. Needs resume_from_cache on and every other segment in the cache. Each selected block starts from the end of the segment before it and its last overlap frames are locked to the start of the cached segment after it, so nothing else is re-rendered. Old files go to _replaced_<time>. 只重跑这些段（从 1 数，和日志一致）：如 3、4-6、8-10, 13-14。留空 = 正常跑。需要打开 resume_from_cache，其余段都要在缓存里。每块开头接上一段结尾，结尾锁到下一段的旧开头，其余段不重跑；旧文件挪到 _replaced_<时间> 留底。 | |
| stop_after | INT | 00–255 | Run segments 1..N only (0 = all). Short test: 1 = only the first segment; set it back to 0 later and the cached segments are reused. 只跑到第 N 段为止（0 = 全部）。短测试填 1 = 只跑第 1 段；之后改回 0，已跑的段从缓存取。 |
| rerun_new_seed | BOOLEAN | true | Re-rendered segments get a new random seed (logged and stored in the cache), so a rerun differs even with the same prompt and refs. Off: the original seed. 重跑的段用新的随机种子（记进日志和缓存），提示词和参考图不变也能抽到不同结果。关：用原种子。 |
| plan | H3MD_PLAN | — | |
| clip | CLIP | — | |
| vae | VAE | Video VAE (pixel route of the lift when rho > 0). | |
| audio_vae | VAE | — | |
| low_res_model | MODEL | Model for the low-res pass (and the high-res pass when high_res_model is not connected). | |
| sampler | SAMPLER | — | |
| sigmas | SIGMAS | One schedule for both passes; split at transition_step. | |
| seed | INT | 00–18446744073709550000 | — |
| cfg | FLOAT | 1.00–100 | — |
| transition_step | INT | 61–10000 | Steps of the schedule run at low resolution; the rest run at full resolution. |
| lowres_scale | FLOAT | 0.500.25–1 | Size of the low-res pass (0.5 = half width and height). |
| rho | FLOAT | 0.000–1 | Share of the most inconsistent positions corrected toward the pixel-VAE route. 0 = learned upscaler only (no VAE round trip). |
| w_min | FLOAT | 0.500–1 | — |
| w_max | FLOAT | 1.000–1 | — |
| upscaler_model | COMBO | none | Learned H3 3D latent upscaler for the lift (models/latent_upscale_models or upscale_models). none = nearest. |
| seed_mode | COMBO | increment | increment (default): segment k uses seed + k, so equal-length segments do not get identical noise; same: every segment uses the seed. With resume_from_cache on, the seed of the run being resumed is reused. |
| decode_output | BOOLEAN | true | Decode every segment (video + audio VAE) after sampling and join the frames like H3MD Segment Join. Off: only the joined latent is produced. |
| high_res_modelopt | MODEL | Model for the high-res pass (default: low_res_model). | |
| highres_tilingopt | BOOLEAN | true | High-res pass: measure the free VRAM and use the fewest strips that fit (full frame when it fits - no cost on large cards). Off = always full frame. |
| cache_modeopt | COMBO | disk | disk: decode each segment right after sampling and write it to a disk cache (RAM holds one segment); merge at the end. ram: original in-RAM decode/join. |
| delete_cacheopt | BOOLEAN | true | Hidden / no effect since 2026-10-18: the Loop never deletes its cache before the video is saved. Use H3MD Save Video Interp -> delete_cache_after_save. |
| resume_from_cacheopt | BOOLEAN | false | Reuse cached segments with identical plan segment, refs, seed and settings (models/LoRAs are NOT checked). The base seed of the run being resumed is reused, so a randomized seed widget does not break the resume. |
| semantic_bridgeopt | H3MD_SEMANTIC_BRIDGE | Optional H3MD Semantic Bridge chain. Not connected = off. | |
| optionsopt | H3MD_LOOP_OPTIONS | H3MD Loop Options (advanced switches). Not connected = all defaults. | |
| depth_controlopt | H3MD_DEPTH | H3MD Depth Control (optional, appended LAST): depth ControlNet on the low-res stage for plan videos with 'depth' ticked. Not connected = off. |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| latent | LATENT | Joined audio-video latent of all segments (seam overlaps removed). Can be connected externally (e.g. Separate AV Latent -> Hyper-VAE / VAE Decode -> VHS Video Combine) for upscaling or custom processing. NOT bounded: decoding the whole latent holds the whole clip in VRAM/RAM on long videos. Bounded path: 'long video' -> H3MD Save Video Interp. 拼好的音视频 latent，可接外部节点（如 Hyper-VAE / VAE 解码 → VHS Video Combine）放大或自定义处理；长视频整段解码可能爆显存/内存。 |
| images | IMAGE | Placeholder only (64x64; merge_images was removed) - NOT the video. For frames, decode 'latent' externally, or save with 'long video' -> H3MD Save Video Interp. (cache_mode=ram: still the whole clip in RAM.) 只是占位图，不是视频；要画面帧请在外部解码 'latent'，或用 'long video' → H3MD Save Video Interp 出片。 |
| audio | AUDIO | Joined audio of the whole clip (the same audio H3MD Save Video Interp writes). Can be connected externally for custom processing; not a bounded-memory path on large / long videos. 整段拼好的音频，可接外部节点自定义处理；大/长视频不保证不爆内存。 |
| frame_count | INT | Number of video frames of the joined clip (24 fps). |
| summary | STRING | JSON report of every segment. |
| long video | H3MD_SEGMENTS | Cache folder + merge plan for H3MD Save Video Interp - the only output designed to stay within bounded VRAM/RAM (streamed chunk by chunk from the disk cache). None with cache_mode=ram. 接 H3MD Save Video Interp：唯一按有限显存/内存设计的出片路径。 |