跳转至

Media Generation Conditioning 算子节点

将单张或多张条件参考图像（或参考视频）与特定帧位布局及引导强度打包整合，随时连入任何支持多模态媒体条件注入的扩散管线。

算子所属分类：ModularDiffusion/Conditioning

核心速查 (TL;DR)

  • 连入管线即可激活量身定制的专属预设：连接 pipeline 端口后，表单会自动切换为专为该模型设计的拓扑插槽（例如针对 WAN 图生视频管线自动调出“首帧/尾帧”插槽）；
  • 独立模式下的高自由度编排：在未连接管线时，呈现高度灵活的图像/视频通用布局与“预设 (Preset)”下拉选择器；在“Custom”自定义预设模式下，可通过滑块自由指定图像插槽数量；
  • 与生成算子无缝对接：将输出的 conditioning 凭据连入 Generate Media Latents 节点的 media_conditions（适用于 LTX / LTX2 / WAN）或 reference_images（适用于 Flux2 Klein）输入端口。

典型工作流编排拓扑

Pipeline Builder ──────────────────────────────────────────┐
                                                           ├─→ Generate Media Latents → Decode
Load Image (起始首帧) ──┐                                  │
Load Image (终点尾帧) ──┴─→ [Media Generation Conditioning] ─┘

节点外观预览

Media Generation Conditioning 算子节点外观

输入端口规范 (Inputs)

端口名称 数据类型 是否必填 详细功能与业务规范说明
pipeline Pipeline Config 否 来自 Pipeline Builder。连入后，节点表面会自动根据该架构的特点重组条件插槽布局。
image_{i} ImageUrlArtifact 否 编号为 i 的条件参考图像插槽。仅在图像模式下显现；插槽数量取决于当前选定的预设或自定义设置。
video VideoUrlArtifact 否 条件参考视频素材。仅在视频模式下显现。

输出端口矩阵 (Outputs)

端口名称 数据类型 详细功能与业务规范说明
conditioning media_gen_conditioning 强类型条件凭据，打包了所有参考图像/视频、帧位时序索引与引导强度权重。直接喂给 Generate Media Latents 对应的条件端口。

属性参数调优 (Parameters)

模态与预设选择组 (Mode and preset selection)

参数名称 数据类型 默认值 详细业务功能与调优说明
mode 单选枚举 (image \| video) image 条件模态选择。当连接的管线仅支持单一模态时该项自动隐藏。切换该项将完全重新生成输入插槽。
image_preset 下拉枚举 Custom 图像插槽布局预设下拉框。可选选项与出厂默认值严格取决于所连接的管线架构（详见下方行为说明）。视频模式下隐藏。
num_images 整数滑块 0 参考图像插槽数量。仅在 image_preset = Custom 时可见。默认取值范围为 0~8；可能受管线配置进一步约束。

图像插槽属性 (图像模式下每个激活插槽独立拥有一组)

参数名称 数据类型 默认值 详细功能说明
image_{i}_frame_index int 0 该图像在最终输出视频中的目标时序帧位。在预设模式下（帧位被预设硬性锁定）或在不适用的静态管线（如 Flux2 Klein）中隐藏。
image_{i}_strength float (0.0~1.0) 1.0 该插槽参考图像的条件引导强度。在不支持逐图强度调节的管线下隐藏。

视频模式属性 (Video mode)

参数名称 数据类型 默认值 详细功能说明
frame_index int 0 参考视频在最终成片视频中开始介入对齐的起始帧索引。
video_strength float (0.0~1.0) 1.0 注入视频的全局条件引导权重。

模型与提供方自适应规范 (Provider behavior)

1. 未连接任何管线时 (出厂默认状态)

图像与视频模式均可自由切换。Preset 候选：Custom（默认，支持自定义 num_images (0~8)、帧索引与强度）、First + Middle + Last（首帧+中帧+尾帧）、First + Last（首帧+尾帧）、First frame（仅首帧）。视频模式下展示单路 video 插槽及对应帧索引与强度控制项。

2. WAN 视频生成管线 (WAN Image-to-Video)

仅支持图像模式。Preset 候选：First + Last（默认首尾双关键帧）、First frame（首帧引导）。

3. LTX / LTX2 视频管线

支持双模态。在图像模式下，First + Middle + Last 出厂默认激活。

4. Flux2 Klein 图像管线

仅支持图像模式。提供 1~8 个高灵活性参考图像插槽。注意：Generate Media Latents 上的 reference_images 输入插槽通常需在同时连入局部重绘蒙版时才会完全激活生效。

避坑技巧与最佳实践 (Tips & pitfalls)

  • 强烈推荐率先连入 pipeline：一旦连入管线，节点表面会瞬间感知并自动重置为该模型最原生、最合规的预设布局，省去手动反复调节插槽数量与帧索引的繁琐工作。
  • 命名预设会锁定关键帧时序：当你选定具名的结构化预设（如 First + Last）时，每个插槽在时间轴上的输出位置由算法硬编码完全锚定（例如插槽 0 严格锁定在第 0 帧，插槽 1 严格锚定在最后一帧），表单会自动折叠隐藏 frame_index 控件。若你需要将参考图精准钉在第 15 帧或第 30 帧，请果断切换为 Custom 预设。
  • frame_index 的物理定位心智模型：0 代表将参考图物理锚定在生成视频的第 1 帧（初始首帧）；-1 则指示调度器将其对齐在视频流的最后一帧（结束尾帧）。

推荐延伸阅读