跳转至

Decode Media Latent 算子节点

调用管线绑定的 VAE 解码器(Decoder)对去噪完成的潜空间张量执行逆变换解码,反显出直观的人类可视图像或连续视频流——绝大多数模块化扩散生成工作流的终极收束节点。

算子所属分类:ModularDiffusion/Encode\Decode


核心速查 (TL;DR)

  • 输出端口与帧率自适应动态演进:输出端口类型具备自适应感知能力:连入静态图像管线时显现为 output_image;连入时序视频管线(如 LTX、LTX2、WAN)时,表面会自动切换为 output_video 并动态呈现 fps 帧率调节滑块;
  • 标准工作流的终点出口:通常作为扩散流水线的最后一环;将输出端口直接连入下游的图像保存 (Save Image) 或视频落盘 (Save Video) 节点即可完成资产持久化。

典型工作流编排拓扑

Generate Media Latents → [Decode Media Latent] → Save Image / Save Video

节点外观预览

Decode Media Latent 算子节点外观


输入端口规范 (Inputs)

端口名称 数据类型 是否必填 详细功能与业务规范说明
pipeline Pipeline Config 是 来自上游 Pipeline Builder。必须与当初生成该潜变量的管线架构完全相同,以确保调用正确匹配的 VAE 解码器。
latent_tensor LatentArtifact 是 待解码的反向潜空间特征张量(通常来自 Generate Media Latents 的去噪成果)。

输出端口矩阵 (Outputs)

端口名称 数据类型 详细功能与业务规范说明
output_image ImageArtifact 解码还原出的最终静态高清图像(仅在图像管线下呈现)。
output_video VideoUrlArtifact 解码还原并封装合成的连续高动态视频文件(仅在视频管线下呈现)。

属性参数调优 (Parameters)

参数名称 数据类型 默认值 详细业务功能与调优说明
fps int (1~120) 25 导出的视频播放帧率(帧/秒)。仅在视频管线模式下显现。

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

  • 解码管线必须与生成管线架构严格匹配:每种扩散模型均携带与其联合训练、高度绑定的专用 VAE 网络——用 SDXL 的 VAE 强行解码 Flux 潜变量,最终只会产出彻底色彩错乱、完全损毁的静态噪波图像。
  • 大画幅与长视频解码阶段的显存压力:超高分辨率或超长帧数的潜变量张量在进入 VAE 解码全连接逆卷积阶段时,会对物理显存带来极大的瞬时脉冲开销。若在解码瞬间遭遇 CUDA OOM 崩溃,请务必返回最初的 Pipeline Builder 节点,将 vae_slicing 显存切片选项置为开启状态(以微小批次串行解码,大幅压低显存波峰)。

推荐延伸阅读