MiniMax H3 Prompt Relay Conditioning / 分段提示词条件 (Advanced)
The node that actually installs the relay — encode the plan, patch a cloned model
- model
- clip
- video_vae
- audio_vae
- prompt_relay_plan
- drive_audio
- final_audio
- first_frame
- last_frame
- ref_images
- ref_videos
- ref_video_audios
- ref_audios
- model
- positive
- av_latent
- mux_audio
- conditioned_prompt
- media_map_json
- report_json
Everything before this node is just paperwork. The Plan holds your global prompt and timed events; MiniMaxH3PromptRelayConditioningT8Advanced is where the relay becomes real: it authoritatively encodes the plan through the native H3 Qwen chain, binds exact local token spans, and optionally patches a cloned H3 MODEL with a bounded-memory, plan-selected query relay. Output is a new model, positive conditioning, and a ready av_latent - the whole downstream chain, in one node.
If that sounds like a lot of moving parts, it is, and the author has engineered it so you can't blow yourself up by accident. Default execution_mode is report_only: it encodes and reports token/layout/VRAM numbers but does not install the attention routing. You check the report, then explicitly flip to apply_exp. The node also self-limits: with zero local events it passes through unchanged, and with exactly one event it installs no patch either - a single event belongs in global_prompt, not a relay.
The inputs that matter
model,clip,video_vae,audio_vae- native H3 components. The model output is a local clone, so your original MODEL stays untouched elsewhere in the graph.prompt_relay_plan- must come directly from a same-version Plan node. Plan mismatch is a hard error, not a warning.task_type- T2VA/I2VA/FL2VA/L2VA/Ref2VA/Hybrid. Relay routes the target video time axis for all of them; extending to target audio requires the separate Query Route node withjoint_av_exp.audio_mode-native,lock_source,remix, orreference. Want the original audio preserved? Uselock_sourceand wire the node'smux_audiooutput to your save node - not AV Decode'sgenerated_audio. The README is adamant about this wiring.audio_denoise_strength(0.35),add_source_as_reference(true),prompt_primary_audio_ordinal,strict_prompt_tags(true) - the audio-conditioning bundle.execution_mode-report_only→apply_exp. Start here, always.query_chunk_rows(256) - smaller chunks save VRAM but run slower; the report tells you if you're near a cliff.
Outputs: model, positive, av_latent, mux_audio, conditioned_prompt, media_map_json, report_json.
Ordering rules that will bite you
With Turbo8 the README requires the chain UNET → Prompt Relay Conditioning → Alpha8 Bypass LoRA → DualClock Sampler - put the LoRA before the relay and it's actively rejected. And drive_audio is a joint generation condition, not a deterministic lip-sync guarantee: if you need the exact input voice, lock_source + a <Audio N> reference is the strongest option, but don't expect per-phoneme mouth sync without a dedicated face/lip tool afterwards.
Install
Part of the MiniMax H3 Audio T8 pack:
cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8
or search "MiniMax H3 Audio T8" in ComfyUI Manager and restart. No pip deps; you supply H3 weights, Qwen3-VL CLIP, video and audio VAEs yourself. The eleven relay templates under examples/workflows/14-prompt-relay/ each wire this node, with per-task wiring notes on the canvas - start with the Stock20 T2VA template and read the report_only output before you ever switch to apply_exp.
Inputs (25)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | 原生 MiniMax H3 MODEL;输出为局部克隆。 | |
| clip | CLIP | 原生 MiniMax H3 Qwen3-VL CLIP。 | |
| video_vae | VAE | MiniMax H3 video VAE。 | |
| audio_vae | VAE | MiniMax H3 audio VAE。 | |
| prompt_relay_plan | H3_T8_PROMPT_RELAY_PLAN | 必须直接来自同一版本 Prompt Relay Plan 节点。 | |
| width | INT | 105632–16384 | — |
| height | INT | 60832–16384 | — |
| task_type | COMBO | T2VA | 支持 T2VA/I2VA/FL2VA/L2VA/Ref2VA/Hybrid 的目标视频时间路由;显式接入 Query Route 后可实验性扩展到目标音频。 |
| audio_mode | COMBO | native | 支持原生生成、锁定源音频、重混源音频和仅参考音频。默认Plan只路由目标视频;joint_av_exp会直接路由目标音频,不能与lock_source组合。 |
| audio_denoise_strength | FLOAT | 0.350–1 | — |
| add_source_as_reference | BOOLEAN | true | — |
| prompt_primary_audio_ordinal | INT | 10–9 | — |
| strict_prompt_tags | BOOLEAN | true | — |
| ref_image_size | COMBO | match | 2 options: match, max |
| reference_video_policy | COMBO | official_2_to_15s | 2 options: official_2_to_15s, model_minimum |
| execution_mode | COMBO | report_only | 先用 report_only 检查 token/layout/显存报告;确认后显式选择 apply_exp 才安装注意力路由。零个或一个局部事件时会自动原样直通,不安装补丁;单事件通常应合并进 global_prompt。 |
| query_chunk_rows | INT | 25632–2048 | 目标视频/显式联合音频 query 分块。更小更省显存但更慢;不会创建完整 S×S mask。 |
| drive_audioopt | AUDIO | — | |
| final_audioopt | AUDIO | — | |
| first_frameopt | IMAGE | — | |
| last_frameopt | IMAGE | — | |
| ref_imagesopt | COMFY_AUTOGROW_V3 | — | |
| ref_videosopt | COMFY_AUTOGROW_V3 | — | |
| ref_video_audiosopt | COMFY_AUTOGROW_V3 | — | |
| ref_audiosopt | COMFY_AUTOGROW_V3 | — |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| model | MODEL | — |
| positive | CONDITIONING | — |
| av_latent | LATENT | — |
| mux_audio | AUDIO | — |
| conditioned_prompt | STRING | — |
| media_map_json | STRING | — |
| report_json | STRING | — |