> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SeedVR2ProgressiveSampler - ComfyUI Built-in Node Documentation

> Complete documentation for the SeedVR2ProgressiveSampler node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# SeedVR2ProgressiveSampler

用于 SeedVR2 原生工作流的顺序时间分块采样器。此节点通过将长视频潜变量拆分为更小的时间块，依次对每个块进行采样，并将结果混合在一起。当使用 SeedVR2 模型处理会导致内存溢出的序列时，它可作为标准 KSampler 的直接替代品。

## ## 输入

| 参数                 | 描述                                                                     | 数据类型         | 必需 | 范围                     |
| ------------------ | ---------------------------------------------------------------------- | ------------ | -- | ---------------------- |
| `model`            | 用于对输入潜变量进行去噪的模型                                                        | MODEL        | 是  |                        |
| `seed`             | 用于生成噪声的随机种子（默认值：0）                                                     | INT          | 是  | 0 到 0xffffffffffffffff |
| `steps`            | 去噪过程中使用的步数（默认值：20）                                                     | INT          | 是  | 1 到 10000              |
| `cfg`              | 无分类器引导尺度，用于平衡创造性与对提示的遵循程度。值越高，生成的图像与提示匹配度越高，但过高的值会负面影响质量（默认值：1.0）      | FLOAT        | 是  | 0.0 到 100.0            |
| `sampler_name`     | 采样时使用的算法，会影响生成输出的质量、速度和风格                                              | COMBO        | 是  | 提供多个选项                 |
| `scheduler`        | 调度器控制噪声逐步去除以形成图像的方式                                                    | COMBO        | 是  | 提供多个选项                 |
| `positive`         | 描述您希望在图像中包含的属性条件的条件化数据                                                 | CONDITIONING | 是  |                        |
| `negative`         | 描述您希望从图像中排除的属性条件的条件化数据                                                 | CONDITIONING | 是  |                        |
| `latent`           | 待去噪的潜变量图像                                                              | LATENT       | 是  |                        |
| `denoise`          | 应用的去噪程度，较低的值将保持初始图像的结构，允许进行图像到图像的采样（默认值：1.0）                           | FLOAT        | 是  | 0.0 到 1.0              |
| `frames_per_chunk` | 每个时间块的像素帧数。必须为 4n+1 的值（1, 5, 9, 13, 17, 21, ...）以符合 SeedVR2 约束（默认值：21） | INT          | 是  | 1 到 16384（步长为 4）       |
| `temporal_overlap` | 相邻块之间混合的潜变量帧数，用于隐藏接缝；0 表示不混合（默认值：0）                                    | INT          | 是  | 0 到 16384              |
| `chunking_mode`    | manual = 精确使用 `frames_per_chunk`；auto = 缩小块大小直到适配显存（默认值："manual"）      | COMBO        | 是  | "manual"<br />"auto"   |

**关于 `frames_per_chunk` 的说明：** 此参数必须为 4n+1 的像素帧数（1, 5, 9, 13, 17, 21, ...）。如果提供无效值，节点将报错。

**关于 `temporal_overlap` 的说明：** 重叠值会自动限制为最多比潜变量块大小小 1，以确保有效的块处理。

**关于 `chunking_mode` 的说明：** 当设置为 "auto" 时，如果当前块导致内存溢出错误，节点将自动尝试更小的块大小。如果所有尝试均失败，节点将报错。

## ## 输出

| 输出名称     | 描述                                     | 数据类型   |
| -------- | -------------------------------------- | ------ |
| `latent` | 去噪后的潜变量输出，从所有时间块拼接回单个折叠的 SeedVR2 潜变量张量 | LATENT |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SeedVR2ProgressiveSampler/zh.md)

***

**Source fingerprint (SHA-256):** `a4574c3e619954b5569551b5b2ba112ecbff918dcebb5ba718a14e77701144a9`