ComfyPilotComfyPilot
文档 / 节点说明 / 设置参考多潜空间

设置参考多潜空间

此节点对一个或多个参考图像进行编码,并将其 latent 附加到编辑模型所使用的条件中。

节点说明 ReferenceMultiLatent 更新于 2026-11-12

查看官方原文

设置参考多潜空间 - ComfyUI Built-in Node Documentation

此节点对一个或多个参考图像进行编码,并将其 latent 附加到编辑模型所使用的条件中。

此节点对一个或多个参考图像进行编码,并将其 latent 附加到编辑模型所使用的条件中。它是 Set Reference Latent 的多图像对应节点:你连接一个 VAE 以及一组参考图像,该节点会将每个编码后的 latent 附加到正向条件,并且当连接了负向条件时,也会附加到负向条件。当模型期望一次使用多张参考图像而不是单个 latent 时,请使用它。

输入

通用输入

参数描述数据类型必填范围
positive要使用参考 latent 修改的正向条件。CONDITIONING是-
negative可选的负向条件,会接收相同的参考 latent。保持未连接,以在 negative 输出上复用修改后的正向条件。CONDITIONING否-
vae用于编码已连接参考图像的 VAE。未连接 VAE 时,参考图像会被忽略。VAE否-
resolution每张参考图像在编码前的准备方式。"keep resolution" 会按传入尺寸进行编码;"resize" 会将其缩放到目标百万像素数,同时保持宽高比,这会显示 megapixels。(默认值:"keep resolution")DYNAMIC\_COMBO是"keep resolution" "resize"
images可增长槽位:连接一个或多个参考图像(image_1、image_2、...)以用作参考。图像会按槽位顺序编码,并按该顺序附加到条件中。IMAGE否1 到 100

Resize 输入

当 resolution 设置为 "resize" 时,会出现这些选项。

参数描述数据类型必填范围
megapixels每张参考图像的目标大小,同时保持宽高比。1.0 大约为 1024 x 1024 像素。(默认值:1.0)FLOAT是0.01 到 16.0

输出

输出名描述数据类型
positive附加了编码后参考 latent 的正向条件。CONDITIONING
negative附加了相同参考 latent 的负向条件。当未连接负向条件时,返回 positive 输出。CONDITIONING
empty_latent第一个参考 latent 乘以 0.0,可用于初始化采样器。当没有产生参考 latent 时,改为返回按所选分辨率生成的方形空 latent。LATENT

说明

  • latent 是追加的,而不是替换的,因此串联多个 Set Reference Multi Latent 节点会累积参考。
  • 每张连接的图像都会单独编码,因此参考图像不必具有相同尺寸。
  • 未连接 VAE 或未连接任何图像时,positive 和 negative 会原样返回,且 empty_latent 为方形空 latent:1024 x 1024,或在 resolution 为 "resize" 时由 megapixels 决定尺寸。
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑

Source fingerprint (SHA-256): 06f98e7c21e8750a2bdf365cb80fac990bcf01246f183c60ef83bd195fc1225b