对已经编码的 LTX guide,latent_idx 应填写 latent 帧坐标,不是像素帧。接线前先检查 guide 从该位置开始是否越过目标 latent 的帧范围,再核对空间尺寸:guide 与目标尺寸相等,或高和宽分别按相同整数倍缩小。兼容的较小 guide 会被放到稀疏网格上,RoPE 的结束位置也按相同比例扩展,从而覆盖目标画布。
接线前检查坐标和尺寸
- 找到两个视频 latent 输入:
latent是承载 guide 的目标,guiding_latent是已编码 guide。文档规定两者都是形状为(batch, channels, frames, height, width)的 5D 视频 latent。连接节点时以实际类型标签为准,节点颜色只能作为视觉线索。 - 读取 guide 帧数、目标帧数和计划使用的
latent_idx。该索引表示 guide 的起始 latent 帧位置。不要把像素帧时间戳直接填入,也不要套用原始图像或视频的帧索引规则。 - 检查文档规定的末端边界:guide 帧数加上
latent_idx后,不得超过目标 latent 的末端。负索引允许使用,表示 guide 放在目标起点之前;它不是从目标末尾倒数。文档没有给出越过起点时可使用多少 guide 内容的单独规则,因此不要从末端检查推断起点处的裁切或保留方式。 - 分别比较高和宽。空间尺寸相等时有效;否则,目标的高、宽必须分别是 guide 对应尺寸乘以同一个整数。任一比例不是整数,或高宽比例不同,都应视为不兼容。
- 完成检查后再接入 latent guide 节点。必需的
vae输入用于读取帧放置的下采样索引公式;单独的latent_idx输入设置 guide 的起点,计数单位为 latent 帧。该节点接入已经编码的 latent guide,不需要图像 guide 路径中的 VAE 解码、再编码往返。输入和边界规则见官方节点文档。
假设验收工作表
以下数据仅是假设的接线前检查,不是软件测试结果。假设目标有 12 个 latent frames,空间尺寸为 96 × 64,guide 有 3 帧。工作表按文档给出的末端范围检查比较;它不声称实现对越过起点的帧会如何处理。
| 检查项 | 假设观察 | 判断 |
|---|---|---|
latent_idx=8 | 3 个 guide 帧加起点 8,合计为目标的 12 帧 | 通过文档规定的末端范围检查;还需确认起点是否符合预期 |
latent_idx=10 | 3 个 guide 帧加起点 10,超过 12 帧 | 未通过文档规定的末端范围检查;改用能容纳 guide 的起点,或选择帧范围合适的目标 |
| guide 为 48 × 32 | 目标与 guide 的高、宽比例均为 2 | 空间尺寸兼容;文档描述为稀疏网格扩展,RoPE 结束位置按相同比例扩展 |
| guide 为 48 × 24 | 高的比例为 2,宽的比例不是 2 | 空间尺寸不兼容;文档说明非方形比例会报错 |
从实际连接的 latent 数据读取帧数和空间尺寸,不要用源图像的像素尺寸代替。表格是作者建议的对照方法;判断中的功能行为和失败条件依据节点文档。
限制与失败后的下一步
帧范围检查失败,表示按文档的末端规则,guide 放在该起点时无法容纳。重新确认哪个 latent 是目标,再调整计划起点,或改用帧范围足以容纳 guide 的目标 latent。不要把像素帧索引当作变通方式。
空间尺寸不兼容时,调整 latent_idx 无法解决:索引定位的是帧,空间比例是另一项独立约束。如果高宽的缩小倍数不相同,应改用空间比例匹配的 guide 与目标 latent,再核对尺寸。文档未说明节点会自动缩放不兼容输入,不应假设它会替你修正。
稀疏网格和 RoPE 的说明描述的是放置与覆盖范围,不是画质、语义保真度或必然出现的视觉结果。strength 上限为 1.0;文档说明需要进一步增强时应使用 attention_mask,但这不能替代有效的帧范围或空间比例。准确输入要求可查阅官方节点输入与说明。
常见追问
`latent_idx=8` 是像素帧 8 吗? 不是。它是 latent 帧起点。尚未编码的图像或视频使用的像素帧索引属于另一种坐标单位。
guide 的高和宽都是目标的一半,可以用吗? 可以,前提是两个尺寸确实都恰好缩小一半。文档将其描述为 x2 空间参考,并规定以稀疏网格扩展及相应的 RoPE 位置扩展来放置。
guide 从目标起点之前开始怎么办? 允许使用负 `latent_idx`,表示 guide 位于目标起点之前。文档仍规定 guide 不得越过目标末端,但没有说明额外的裁切或部分 guide 处理方式。
来源与下一步
本文依据公开文档解释操作,并使用明确标注的假设验收示例,不是软件实测。控件与可用功能可能变化,请对照所引手册和你的安装版本。
若你在 Imagild 中继续创作,可将输入要求和验收清单带到微电影工作台。上文讨论的外部软件控件属于其各自产品。