> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TopazVideoEnhanceV2 - ComfyUI Built-in Node Documentation

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

**Topaz Video Enhance V2** 节点允许您使用 Topaz Labs 的 AI 模型对视频进行放大和增强。它可以提高分辨率、通过插值调整帧率，并应用创意或写实增强效果，为您的视频素材注入新的活力。

## 输入

| 参数                                                      | 描述                                                                                                                            | 数据类型          | 是否必填 | 取值范围                                                                                                                             |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------- |
| `视频`                                                    | 待处理的输入视频。必须为 MP4 容器格式。                                                                                                        | VIDEO         | 是    | -                                                                                                                                |
| `放大模型`                                                  | 用于放大视频的 AI 模型。选择 "Disabled" 表示不应用任何放大处理。                                                                                      | COMBO         | 是    | `"Astra 2"`<br />`"Starlight (Astra) Fast"`<br />`"Starlight (Astra) Creative"`<br />`"Starlight Precise 2.5"`<br />`"Disabled"` |
| `upscaler_model.upscaler_resolution`                    | 放大器的目标输出分辨率。当选择了放大器模型（非 "Disabled"）时，此参数为必填项。                                                                                 | COMBO         | 条件必填 | `"FullHD (1080p)"`<br />`"4K (2160p)"`                                                                                           |
| `upscaler_model.creativity`                             | 放大的创意强度。仅适用于 "Astra 2" 和 "Starlight (Astra) Creative" 模型。对于 Astra 2，它是一个滑块（默认值：0.5）。对于 Starlight Creative，它是一个组合框（默认值："low"）。 | FLOAT / COMBO | 条件必填 | Astra 2: 0.0 至 1.0（步长 0.1）<br />Starlight Creative: `"low"`<br />`"middle"`<br />`"high"`                                        |
| `upscaler_model.prompt`                                 | 可选的描述性（非指令性）场景提示。仅适用于 "Astra 2" 模型。设置后，输入帧数上限为 500 帧（约 30fps 下的 15 秒）。默认值：空。                                                  | STRING        | 否    | -                                                                                                                                |
| `upscaler_model.sharp`                                  | 预增强锐度：0.0=高斯模糊，0.5=直通（默认值），1.0=USM 锐化。仅适用于 "Astra 2" 模型。默认值：0.5。                                                              | FLOAT         | 否    | 0.0 至 1.0（步长 0.01）                                                                                                               |
| `upscaler_model.realism`                                | 将输出向摄影写实方向靠拢。保持为 0 则使用模型默认值。仅适用于 "Astra 2" 模型。默认值：0.0。                                                                        | FLOAT         | 否    | 0.0 至 1.0（步长 0.01）                                                                                                               |
| `插值模型`                                                  | 用于帧插值的 AI 模型。选择 "Disabled" 表示不应用任何插值处理。                                                                                       | COMBO         | 是    | `"Disabled"`<br />`"apo-8"`                                                                                                      |
| `interpolation_model.interpolation_frame_rate`          | 输出帧率。当插值模型为 "apo-8" 时必填。默认值：60。                                                                                               | INT           | 条件必填 | 15 至 240                                                                                                                         |
| `interpolation_model.interpolation_slowmo`              | 应用于输入视频的慢动作倍数。例如，2 会使输出速度减半，时长加倍。默认值：1。                                                                                       | INT           | 否    | 1 至 16                                                                                                                           |
| `interpolation_model.interpolation_duplicate`           | 分析输入中的重复帧并将其移除。默认值：False。                                                                                                     | BOOLEAN       | 否    | True/False                                                                                                                       |
| `interpolation_model.interpolation_duplicate_threshold` | 重复帧的检测灵敏度。默认值：0.01。                                                                                                           | FLOAT         | 否    | 0.001 至 0.1（步长 0.001）                                                                                                            |
| `动态压缩等级`                                                | 视频压缩的 CQP 级别。默认值："Low"。                                                                                                       | COMBO         | 否    | `"Low"`<br />`"Mid"`<br />`"High"`                                                                                               |

**重要限制：**

* `upscaler_model` 或 `interpolation_model` 中至少有一个必须启用（非 "Disabled"），否则将引发错误。
* 输入视频必须为 MP4 容器格式。
* 带有提示词的 "Astra 2" 模型限制为 500 个输入帧（约 30fps 下的 15 秒）。无提示词时，帧数限制更高。
* 当 `upscaler_model` 非 "Disabled" 时，`upscaler_resolution` 子参数为必填项。
* 当 `interpolation_model` 非 "Disabled" 时，`interpolation_frame_rate` 子参数为必填项。

## 输出

| 输出名称 | 描述                     | 数据类型  |
| ---- | ---------------------- | ----- |
| `视频` | 应用所选放大和/或插值滤镜后的增强视频输出。 | VIDEO |

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

***

**Source fingerprint (SHA-256):** `29b7538206327c35866126c1862c1d1ccea872ba84fbb9c84126114a06e2b00f`
