Nodes/ComfyUI_MinimaxH3_AutoContext/Minimax_H3_AutoContext_parameter
ComfyUI Node

Minimax_H3_AutoContext_parameter

The dashboard for MiniMax H3 long videos — this is where you actually type the prompt

By supElement·Created 3 months ago·Updated 4 days ago· 36
Minimax_H3_AutoContext_parameter
  • shot_info
  • parameter
◄long_prompt►
◄clip_modeClip_Tag►
◄clip_tag段1►
◄prompt_formatofficial►
◄crop_modestretch►
◄ref_sync_modesegmented►
◄width960►
◄height544►
◄total_frames362►
◄fps24►
◄chunk_frames90►
◄context_frames22►
◄lock_audiotrue►
◄audio_drivefalse►
◄video_guidenone►
◄semantic_bridgefalse►
◄semantic_bridge_adapter▾►
◄semantic_bridge_alpha0.10►
◄semantic_bridge_magnitudeper_token►

If you grabbed the AutoContext sampler and wondered where the prompt box is - it's here. This pack splits the work: H3Parameter is a pure configuration node, a dict-builder that bundles your prompt, resolution, frame counts and audio settings into a single parameter output. That dict is the sampler's required input. One parameter node, one sampler, nothing else to wire.

It also shows a live "expected segmentation" preview on the node itself. That's a front-end JavaScript calculation, not inference - it just shows roughly how your video will split into chunks before you burn GPU time. Genuinely handy when you're tuning, and worth knowing it won't tell you anything about quality.

The inputs that matter

  • long_prompt - the prompt. This is the one you'll spend all your time on.
  • total_frames / chunk_frames / context_frames - the heart of the chunking. Defaults: 362 total (~15s at 24fps), 90 per chunk, 22 context. MiniMax H3's VAE works on a 17-frame temporal grid, so valid counts are 5, 22, 39, 56, 73, 90… The node snaps your numbers onto that grid, so don't fight it. Context frames are the previous segment's tail that carries into the next one - bigger means a smoother relay, and 22 is a good starting point.
  • fps - only used for audio sync and converting the seconds in your prompt to frames. 24 by default.
  • width × height - first-pass resolution (960×544 default). On a second pass the sampler ignores these and follows the input latent instead.
  • lock_audio - on by default. During a second pass, only video gets re-sampled; the audio from pass one is reused. audio_drive flips it around: pair it with a drive_audio connection on the sampler and the video follows that specific soundtrack instead of generating its own.

The timeline stuff

prompt_mode has four personalities. auto (default) reads time markers like 0-5s in your prompt and slices accordingly, while untagged lines (style, soundscape, negative-ish notes) get spliced into every window. timeline forces the same, stricter. global dumps the entire prompt into every window - honestly the right choice for a one-shot homogeneous scene like a looped background or a talking head, and it sidesteps the trickiest limitations below. sequential lays lines out in order, with 全局:/[global] lines shared across all windows. If you're new to this, use global until you actually need per-scene direction.

clip_mode switches between Clip_Frame (even time slicing) and Clip_Tag, which splits by your own labels like 段1 / 段2 (the tag must end in a number, so A01 and [片段001] work too). Each tag becomes a full chunk; its duration comes from the tag's time range, then the segment's internal time markers, then a total_frames fallback. That's your shot-list mode.

Two limitations to keep in mind - the README calls them the node's constraints, and they only bite in segmented modes. First, temporal exclusivity: each chunk's prompt must describe only what's new relative to the previous chunk's end, because that end is the implicit starting state. Rewriting the previous chunk's action in the next one causes conflict and jittery motion. Second, references aren't remembered: if chunk 2 uses image1, chunk 2's prompt has to declare image1 again, or it runs without it.

Install and outputs

Same install as the whole pack: ComfyUI Manager, search ComfyUI_MinimaxH3_AutoContext, or git clone https://github.com/supElement/ComfyUI_MinimaxH3_AutoContext.git into custom_nodes and restart. No extra dependencies for this node itself - the pack's requirements only add scenedetect and opencv-python-headless for the seam-correction sibling.

The output is one parameter dict, and it's the sampler's required parameter input. That's the entire job: this node doesn't generate anything, it just makes the main node much less cluttered. Also note the pack downloads no model - H3 itself comes from ComfyUI's native MiniMax H3 support, and if you're in the US, EU, UK or Korea, the H3 Community License doesn't grant you rights to run the local weights there. Worth checking before you invest an afternoon.

CategoryMinimaxH3_AutoContext

Inputs (20)

NameTypeDefaultDescription
long_promptSTRINGPrompt (passed to the main node for inference and also used for the "expected segments" preview) 提示词 (传给主节点推理,同时用于「预计分段」预览)
clip_modeCOMBOClip_TagHow the prompt maps onto video segments: Clip_Tag splits by custom tags; timeline splits by time markers; sequential tiles by sentence order; global uses the whole prompt for every segment. In Clip_Tag and timeline modes total_frames and chunk_frames are ignored and segment length is decided by the prompt. 提示词映射到视频段的方式:Clip_Tag按自定义标签分段;timeline按时间标记分段;sequential按句读顺序平铺;global整段用于所有段。Clip_Tag和timeline模式下,total_frames和chunk_frames无效,段长由提示词决定。
clip_tagSTRING段1Split-tag template for Clip_Tag mode (only used in Clip_Tag mode). It must end with a numeric index, e.g. '段1' (prefix '段' + 1 digit), 'A01' (prefix 'A' + 2 digits), '[片段001]' (prefix '[片段' + 3 digits + suffix ']'). A tag only splits segments when it occupies a line of its own; a line break after the tag is recommended, without one the separators (::,,。;; —–- space) are skipped to take the segment content. The tags themselves are removed at inference time. Times written inside the prompt stay in seconds Clip_Tag 模式的分割标签模板 (仅 Clip_Tag 模式生效)。必须以数字序号结尾,如 '段1' (前缀'段'+1位数字)、'A01' (前缀'A'+2位数字)、'[片段001]' (前缀'[片段'+3位数字+后缀']')。提示词中标签独占一行才作为分割点,标签后推荐换行,不换行时跳过分隔符 (::,,。;; —–- 空格) 取段内容。推理时标签本身会被去除。提示词内时间写法保持秒不变
prompt_formatCOMBOofficialPrompt output format. official: [Shot N] At MM:SS.mmm + <Picture N>/<Video N>/<Audio N> tags + official field names (MiniMax H3 official training format, recommended); legacy: 【0-3秒】+ references kept in their original 1-based style + block headings (old format); raw: references are left completely untouched, output as-is after tag removal with no time-marker conversion (Clip_Tag mode only, segment-relative times kept as-is) 提示词输出格式。official: [Shot N] At MM:SS.mmm + <Picture N>/<Video N>/<Audio N> 标签 + 官方字段名 (MiniMax H3 官方训练格式,推荐); legacy: 【0-3秒】+ 引用保持原写法(1基) + 块标题 (旧格式); raw: 完全不处理引用,去标签后原样输出,不做任何时间标记转换 (Clip_Tag 模式专用,保留段内相对时间原样)
crop_modeCOMBOstretchResize/crop mode for reference images, first/last frames and reference videos. center: scale proportionally and center-crop to the target size; stretch: stretch straight to the target size; none: keep the original resolution with 32-alignment only (advanced option for ref2va scenarios, you handle any size issues yourself) 参考图/首尾帧/参考视频的缩放裁剪模式。center: 等比例缩放并中心裁剪到目标尺寸; stretch: 直接拉伸到目标尺寸; none: 保持原始分辨率,仅做 32 对齐 (高级用户选项,ref2va 场景使用,尺寸问题用户自行处理)
ref_sync_modeCOMBOsegmentedWhether reference video/audio is sliced to each generated segment's time range. global: every segment uses the full reference video/audio (default); segmented: each segment only takes the matching time slice of the reference video/audio, for character replacement with lip sync and similar cases 参考视频/音频是否按生成段的时间范围切片。global: 每段使用完整参考视频/音频 (默认); segmented: 每段只取参考视频/音频中对应时间片段,用于替换人物并保持口型同步等场景
widthINT96064–4096—
heightINT54464–4096—
total_framesINT3625–16376Total frames to generate; must satisfy 17n+5 (5,22,39,56,73,90,...). Times inside the prompt are still parsed in seconds.In Clip_Tag and timeline modes this value is ignored and computed from the prompt content. 生成总帧数,需满足 17n+5 (5,22,39,56,73,90,...)。提示词内时间仍按秒解析。在 Clip_Tag 和 timeline 模式下,该值被忽略,由提示词内容自动计算。
fpsINT248–60Frame rate, used only for audio sync and for converting seconds inside the prompt. Face_Resample standalone mode also uses it for audio slicing (lip sync) — must match the footage 帧率,仅用于音频同步和提示词内秒数换算。Face_Resample 独立模式同样用它做音频切片 (口型) — 必须与素材一致
chunk_framesINT905–2880Frames generated per segment; must satisfy 17n+5 (5,22,39,...). Set it to >= total_frames to generate the whole video as one segment.In Clip_Tag and timeline modes this value is ignored and computed from the prompt content. 每段生成帧数,需满足 17n+5 (5,22,39,...)。设为 ≥ total_frames 时不拆分,整个视频作为一段生成。在 Clip_Tag 和 timeline 模式下,该值被忽略,由提示词内容自动计算。
context_framesINT225–124Tail frames of the previous segment reused for cross-segment continuation. Higher values give stronger continuity; 22 or more is recommended to prevent hard cuts. Valid grid points: 5,22,39,56,73,90,107,124 段间续接用的上一段尾部帧数。值越大连续性越强。建议 22 以上防硬切。有效网格点: 5,22,39,56,73,90,107,124
lock_audioBOOLEANtrueLock the audio region on the second pass / face resample (noise_mask audio=0): only the video is resampled and the audio stays unchanged. 二采/修脸时锁定音频区 (noise_mask audio=0):只重新采样视频、音频保持不变。
audio_driveBOOLEANfalseAudio-drive switch. When checked, the audio region is locked (noise_mask=0) and the video is generated to follow it. 音频驱动开关。勾选后音频区锁定 (noise_mask=0),视频照音频生成。
video_guideCOMBOnoneStrongly anchors multiple frames using the video fed into the ref_video ports. Only consumed by the main sampler node (Face_Resample has no head/tail anchoring path and ignores it) 利用 ref_video 端口输入的视频进行多帧强锚定。仅主采样节点消费 (Face_Resample 无头尾锚定路径, 会忽略该键)。
semantic_bridgeBOOLEANfalseSemantic Bridge (upstream: github.com/Speach1sdef178/MiniMax-H3-Semantic-Bridge). C = H + alpha*(S-H). Distills SenseNova U1.5 teacher into a ~11MB SiLU MLP (5120→512→512→5120) that boosts prompt adherence on the FL2VA/text path. Only transforms the cond tensor; cross-segment keyframe anchors and ref channels are untouched. Put MiniMaxH3_SemanticBridge_v1.safetensors into models/semantic_bridge/. 语义桥 (上游: Speach1sdef178/MiniMax-H3-Semantic-Bridge)。C = H + alpha*(S-H)。把 SenseNova U1.5 教师蒸馏为 ~11MB SiLU MLP (5120→512→512→5120),增强 FL2VA/文本路径的提示词遵循度。只变换条件张量,段间续接锚定与参考素材通道不受影响。适配器放入 models/semantic_bridge/。
semantic_bridge_adapterCOMBOAdapter file. 'none' disables the bridge. 适配器文件,'none' 表示禁用。
semantic_bridge_alphaFLOAT0.100–1Blend strength. Official starting point 0.10; official A/B examples use 0.15. Tune in 0.10~0.15. 融合强度。官方起点 0.10,A/B 示例 0.15。建议在 0.10~0.15 之间微调。
semantic_bridge_magnitudeCOMBOper_tokenMagnitude alignment before blending. Official recommended: per_token. 融合前的幅度对齐方式。官方推荐 per_token。
shot_infooptDICTOptional shot map from Minimax_H3_Face_Cut's shot_info output. When connected, the segment prompts are assigned to these shot intervals: prompt count > shots → take the first N; < shots → repeat the last; the shot interval replaces the time marks inside each prompt 可选: Minimax_H3_Face_Cut 的 shot_info 输出。接入后分段提示词按镜头区间分配: 提示词数多于镜头数取前 N 条, 少于则重复最后一条; 镜头时间段代替每条提示词内的时间标注

Outputs (1)

NameTypeDescription
parameterDICT—