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
节点外观预览

输入端口规范 (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显存切片选项置为开启状态(以微小批次串行解码,大幅压低显存波峰)。
推荐延伸阅读
- Encode Media Latent — 逆向操作算子,负责将像素图像/视频压缩为潜变量
- Generate Media Latents — 典型上游节点,负责输送去噪完成的高维潜变量