3.5 KiB
ComfyUI-H3-Continuum 3.2.4
MiniMax H3を複数チャンクで連続生成し、直前チャンク末尾の映像latent / 音声latentを直接次チャンクへ継承するComfyUIカスタムノードです。チャンク間でVideo/Audio VAEのDecode→Encodeは行いません。
V3.2.4 Stable
V3.2.4は、T2VA / I2VA / FL2VA / Reference + Continuationに対応し、最大3枚のReference ImageとReference Audio 1をCore互換の順序で扱います。First/Last FrameとReference Audioを併用する場合も、Tokenizer側のPicture/Audio表示とDiT側のKeyframe/Audio conditioningを分離して処理します。Run Storage、Spectrum Interop、外部Core VAE Decodeは従来どおりです。
Reference入力のバイパスされたソケットは無視され、有効な画像だけがPicture 1から連続採番されます。プロンプト内の利用できないPicture/Audioタグは警告として扱い、生成は継続します。
Legacy V2.1.7 Stable Facade UI
V2.1.7では、V2.1.6の動的表示制御を廃止し、標準ComfyUI描画だけを使用する静的Facadeへ移行しました。生成処理は互換用H3ContinuumSamplerV2を再利用し、State、Session、Prompt Plan、Spectrum Interop、保存Schemaは変更していません。
通常表示は次を中心にします。
model / clip / video_vae / audio_vae / sampler / sigmas
Sequence Prompt
first_frame
prompt_overrides(任意pack)
advanced(任意pack)
Prompt Format
chunks
chunk_seconds
width / height
continuity
base_seed
control after generate
Seam Correction
Seam Correction
outputs: images / audio / result
補助ノード
H3 Continuum Clip Overrides: Clip別Promptを1本のpackへまとめます。H3 Continuum Advanced: resume/session入力と低頻度設定をまとめます。H3 Continuum Result: resultからlast_state / session / reportを展開します。- 補助ノードを使わない通常生成では、Sampler本体だけで動作します。
Legacy互換
旧H3ContinuumSamplerV2は削除せずLegacy/Coreノードとして登録を維持します。既存WorkflowのノードID、入力順、出力順は変更していません。
Continuity
Auto — conservativeBalanced — 22 frames(標準)Fast — 5 framesStrong — 39 frames (Experimental)
5/22/39フレームはH3の時間latent周期1,4,4,4,4に対して、それぞれ2/7/12 temporal latent stepsです。
Spectrum
Continuumは有効な前チャンクContextがある場合だけh3_continuum Interop API v1をMODEL optionsへ付与し、対応Spectrumへmin_actual_prefix_steps=2を要求します。初回チャンクにはInterop keyを付与しません。未知・未対応Spectrumでは通常Spectrumとしてfail-openします。
推奨配線
UNET -> SageAttention -> Sol-Attn -> LoRA -> Spectrum -> H3 Continuum Sampler
まずchunks=2 / chunk_seconds=5 / Balanced 22f / Seam Correction=OffでNative Continuityを確認し、その後Seam Correction=Autoを比較してください。
インストール
ZIPを展開して、ComfyUI-H3-ContinuumフォルダーをComfyUI/custom_nodes/へ置き、ComfyUIを再起動します。
旧ComfyUI-H3-Continuum-Joinが残っている場合は同時ロードを避けるため削除または退避してください。同梱install_windows.batは旧名・新名の既存フォルダーを日時付きでバックアップします。
検査
python -m compileall -q .
pytest -q
GPL-3.0-or-later。