跳转至

Encode Masked Media Latent 算子节点

将源素材图像与二值遮罩蒙版联合编码为一个结构化的 InpaintMaskArtifact 凭据——该输入类型能全自动触发下游 Generate Media Latents 切换至局部重绘 (Inpainting) 专属执行模式。

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

核心速查 (TL;DR)

  • 局部重绘 (Inpainting) 的专属结构化编码器：产出的专属凭证打包整合了遮罩二值图、被遮罩图像的潜空间张量以及重绘强度 strength，无需下游节点额外引出多根繁琐的分立连线；
  • 全自动下游路由感知：将本节点的 latents 输出端连入 Generate Media Latents 的 input_latent 插槽后，生成节点会自动探测到该专属凭据类型，并自动在底层重定向至对应的 Inpaint 管线分支；
  • 需主干管线具备局部重绘能力：仅支持在底层驱动中注册了有效局部重绘类的管线（例如 Flux Fill、SDXL Inpaint 等）。

典型工作流编排拓扑

Load Image (原图底片) ──┐
                         ├─→ [Encode Masked Media Latent] → Generate Media Latents → Decode
Paint Mask (重绘遮罩) ──┘

节点外观预览

Encode Masked Media Latent 算子节点外观

输入端口规范 (Inputs)

端口名称 数据类型 是否必填 详细功能与业务规范说明
pipeline Pipeline Config 是 来自上游 Pipeline Builder。该管线驱动必须原生支持局部重绘（底层具备 _inpaint_pipeline_class 实现）。
image ImageArtifact / ImageUrlArtifact 是 待修复或重绘的原始素材图像。
mask ImageArtifact / ImageUrlArtifact 是 二值遮罩蒙版——白色像素区域为准备重绘重新生成的区域，黑色像素区域保持原图完全不动。
strength float (0.0~1.0) 否 局部重绘的去噪强度权重，默认值为 1.0。数值越低，重绘区域保留原图高频细节与构图的比例越高。

输出端口矩阵 (Outputs)

端口名称 数据类型 详细功能与业务规范说明
latents InpaintMaskArtifact 打包了蒙版张量、原图潜变量、遮蔽区域潜变量以及重绘强度的聚合凭据对象。

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

  • 管线必须原生支持 Inpainting：若所选的主干模型没有提供 Inpaint 衍生架构，算子在执行时会抛出静态校验异常。若需局部重绘，请在 Pipeline Builder 中挑选类似 Flux Fill 或专用的 SDXL Inpaint 模型。
  • 蒙版物理画幅比例必须与原图一致：虽然节点内部会自动将蒙版重采样到潜变量网格上，但若输入的遮罩与原图的宽高比严重扭曲失配，重绘区域在重采样映射时会发生严重几何形变拉伸。
  • 重绘强度 strength 严格在本节点调节：在 Inpainting 模式下，重绘去噪幅度是直接封装在 InpaintMaskArtifact 凭据之中的，绝不要去下游 Generate 节点寻找强度滑块——请直接在本节点内微调 strength 数值。

推荐延伸阅读