Generate Media Latents 算子节点

驱动核心扩散调度器执行去噪步进循环。接收初始高斯噪声、特征编码张量或已部分去噪的中间潜变量，输出计算完成的去噪潜空间结果。

算子所属分类：ModularDiffusion/Processing

核心速查 (TL;DR)

模块化扩散体系的绝对算力中枢：连入上游构建好的 pipeline 凭据与 input_latent 潜变量；配置好正向提示词与步数参数；点击 Run 即可启动推理；
全动态自适应参数呈现 (Dynamic UI)：所有运行时参数（Prompt 提示词、引导强度 Guidance、时空维度、ControlNet 附加项等）皆具备动态自适应特性——节点会根据所连接的管线架构自动增删与适配输入表单；
原生支持多阶段级联与重绘精炼 (Multi-stage / Rediffusion)：支持在画布上串联多个 Generate 节点，并通过 start_step 与 end_step 参数将整个时间步调度序列切片分段执行；
输出成果为高维特征潜变量——需连入 Decode Media Latent 解码反显为直观的人类可视图像或视频。

Pipeline Builder → Create Noise Latents → [Generate Media Latents] → Decode Media Latent

Generate Media Latents 算子节点外观

端口名称	数据类型	是否必填	详细功能与业务规范说明
`pipeline`	`Pipeline Config`	是	来自上游 Pipeline Builder 或包装过的 ControlNet Pipeline。
`input_latent`	`LatentArtifact` 或 `InpaintMaskArtifact`	是	启动扩散去噪的初始潜变量。可连入初始高斯噪声（文生图/文生视频）、像素编码潜变量（图生图/视频重绘）或上一级 Generate 节点的中间产出（多阶段级联）。
`controlnet_parameters`	`control_parameters`	仅在管线包含 ControlNet 时必填	来自 ControlNet Pipeline 节点的 `control_parameters` 专属透传输出端。
`additional_parameters`	`list[dict]`	否	针对特定模型供应商/架构透传的非标底层微调键值对字典列表。

端口名称	数据类型	详细功能与业务规范说明
`output_latent`	`LatentArtifact`	历经调度器多步去噪演化后的目标潜空间特征张量。
`preview_image`	`ImageUrlArtifact`	运行阶段流式回传的去噪中间帧动态预览——仅在编辑器全局设置中开启 Enable Image Preview Intermediates 时有效。
`progress`	进度条控件 (progress bar)	步进进度指示器，实时渲染当前去噪步数百分比。
`logs`	`str`	记录每一步去噪耗时、调度器时间步演进及显存占用明细的运行日志。

前端实际展示的参数取决于输入管线。常见通用项如下：

参数名称	数据类型	详细业务功能与调优说明
`prompt`	`str`	正向引导提示词文本。
`negative_prompt`	`str`	反向负向提示词——仅在支持无分类器引导 (CFG) 的模型管线（如 SDXL）下显现。
`guidance_scale` / `true_cfg_scale`	`float`	文本与画面的条件契合引导强度。不同架构下的参数命名略有差异。
`num_inference_steps`	`int` (默认 `20`)	调度器迭代去噪的总步长跨度。
`seed`	`int`	随机种子，配合算法逻辑确保构图与演进过程严格复现。

参数名称	数据类型	默认值	详细业务功能与调优说明
`add_noise`	`bool`	`False`	是否在去噪前为输入潜变量按当前时步重新注入适度扰动噪声（图生图、重绘或重扩散工作流的核心开关）。
`start_step`	`int`	`0`	基于零基准 (0-based) 的调度器去噪起始时步索引。
`end_step`	`int`	`-1`	去噪截止时步索引；设为 `-1` 表示执行直至最终时步。

ControlNet 空间控制介入：当输入的 pipeline 包含 ControlNet 包装时，节点表面会自动动态长出 controlnet_parameters 输入端口，并由内部执行空间残差注入。
智能局部重绘 (Inpainting) 路由：当 input_latent 端口接收到的是来自 Encode Masked Media Latent 的 InpaintMaskArtifact 专属凭据时，节点会自动将底层执行逻辑无缝路由至对应的 Inpaint 管线分支，并遵循蒙版中附带的引导强度 strength 执行精准局部修复。

切换上游管线时智能保留连线：若更换了不同架构的 Pipeline Builder，只要新管线中存在相同名称的参数，前端连线会被智能无损继承；同时 UI 会根据新模型规范自动重排排版。
实时中间过程预览会微幅拖慢推理：该选项出厂默认关闭。若需开启，请在 Settings → Modular Diffusion Library → Enable Image Preview Intermediates 中激活。
多阶段时间步精准切片编排：利用 start_step 与 end_step 串联两个 Generate 节点（例如节点 A 执行 0~10 步，节点 B 串接后执行 10~20 步并在节点 B 注入精修 LoRA 或调整 Prompt），轻松实现工业级多阶段渐进式画质打磨。
即时平稳中断响应：在画布点击 Cancel 终止执行时，系统会向底层引擎注入 _interrupt 标记；去噪循环会在当前步长物理计算完成后以安全状态立刻停止退出，绝不造成显存泄漏死锁。
空间与时序分辨率由上游 input_latent 全权裁决：Generate 算子本身不提供 width/height/num_frames 参数——这些维度必须在上游的 Create Noise Latents 或编码算子中进行物理声明。