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

# TopazVideoEnhanceV2 - ComfyUI Built-in Node Documentation

> Topaz Video Enhance V2 节点借助强大的放大与修复技术，为视频注入新的活力。

**Topaz Video Enhance V2** 节点借助强大的放大与修复技术，为视频注入新的活力。它可以使用不同的 Topaz 放大模型提高视频分辨率，通过帧插值调整帧率，并应用创意或写实增强设置。

## 输入

### 通用输入

| 参数       | 描述                                                 | 数据类型           | 是否必需 | 范围                                                                                                                               |
| -------- | -------------------------------------------------- | -------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------- |
| `视频`     | 要处理的输入视频。必须为 MP4 容器格式。                             | VIDEO          | 是    | -                                                                                                                                |
| `放大模型`   | 用于放大视频的 AI 模型。可用的子参数取决于所选模型。选择 `"Disabled"` 将禁用放大。 | DYNAMIC\_COMBO | 是    | `"Astra 2"`<br />`"Starlight (Astra) Fast"`<br />`"Starlight (Astra) Creative"`<br />`"Starlight Precise 2.5"`<br />`"Disabled"` |
| `插值模型`   | 用于帧插值的 AI 模型。可用的子参数取决于所选模型。选择 `"Disabled"` 将禁用插值。  | DYNAMIC\_COMBO | 是    | `"Disabled"`<br />`"apo-8"`                                                                                                      |
| `动态压缩等级` | 用于视频压缩的 CQP 级别（默认值：`"Low"`）。                       | COMBO          | 否    | `"Low"`<br />`"Mid"`<br />`"High"`                                                                                               |

以下各节介绍 `upscaler_model` 和 `interpolation_model` 选择器中每个选项对应的子参数。`"Disabled"` 选项不会显示任何附加参数。

### Astra 2 输入

| 参数                                   | 描述                                                          | 数据类型   | 是否必需            | 范围                                     |
| ------------------------------------ | ----------------------------------------------------------- | ------ | --------------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 放大的目标输出分辨率。                                                 | COMBO  | 是（选择“Astra 2”时） | `"FullHD (1080p)"`<br />`"4K (2160p)"` |
| `upscaler_model.creativity`          | 放大的创意强度（默认值：0.5）。                                           | FLOAT  | 否               | 0.0 到 1.0 (step 0.1)                   |
| `upscaler_model.prompt`              | 可选的描述性（而非指令性）场景提示词。设置后会将输入限制为 450 帧（约 15 秒 @ 30fps）（默认值：空）。 | STRING | 否               | -                                      |
| `upscaler_model.sharp`               | 增强前锐度：0.0=高斯模糊，0.5=直通（默认值），1.0=USM 锐化。                      | FLOAT  | 否               | 0.0 到 1.0 (step 0.01)                  |
| `upscaler_model.realism`             | 使输出更接近摄影写实效果。保留为 0 以使用模型默认值（默认值：0.0）。                       | FLOAT  | 否               | 0.0 到 1.0 (step 0.01)                  |

### Starlight (Astra) Fast 输入

| 参数                                   | 描述          | 数据类型  | 是否必需      | 范围                                     |
| ------------------------------------ | ----------- | ----- | --------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 放大的目标输出分辨率。 | COMBO | 是（选择此模型时） | `"FullHD (1080p)"`<br />`"4K (2160p)"` |

### Starlight (Astra) Creative 输入

| 参数                                   | 描述                    | 数据类型  | 是否必需      | 范围                                     |
| ------------------------------------ | --------------------- | ----- | --------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 放大的目标输出分辨率。           | COMBO | 是（选择此模型时） | `"FullHD (1080p)"`<br />`"4K (2160p)"` |
| `upscaler_model.creativity`          | 放大的创意强度（默认值：`"low"`）。 | COMBO | 否         | `"low"`<br />`"middle"`<br />`"high"`  |

### Starlight Precise 2.5 输入

| 参数                                   | 描述          | 数据类型  | 是否必需      | 范围                                     |
| ------------------------------------ | ----------- | ----- | --------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 放大的目标输出分辨率。 | COMBO | 是（选择此模型时） | `"FullHD (1080p)"`<br />`"4K (2160p)"` |

### apo-8 输入

| 参数                                                      | 描述                                        | 数据类型    | 是否必需          | 范围                       |
| ------------------------------------------------------- | ----------------------------------------- | ------- | ------------- | ------------------------ |
| `interpolation_model.interpolation_frame_rate`          | 输出帧率（默认值：60）。                             | INT     | 是（选择“apo-8”时） | 15 到 240                 |
| `interpolation_model.interpolation_slowmo`              | 应用于输入视频的慢动作系数。例如，2 会使输出速度减半并将时长加倍（默认值：1）。 | INT     | 否             | 1 到 16                   |
| `interpolation_model.interpolation_duplicate`           | 分析输入中是否存在重复帧并将其移除（默认值：False）。             | BOOLEAN | 否             | True<br />False          |
| `interpolation_model.interpolation_duplicate_threshold` | 重复帧的检测灵敏度（默认值：0.01）。                      | FLOAT   | 否             | 0.001 到 0.1 (step 0.001) |

**重要限制：**

* 至少需要启用 `upscaler_model` 或 `interpolation_model` 中的一个。如果两者均设置为 `"Disabled"`，节点将报错，因为没有可处理的内容。
* 输入 `video` 必须是 MP4 容器格式。
* `"Astra 2"` 模型最多支持 9000 个输入帧。设置 `prompt` 后，限制为 450 个输入帧（30 fps 下约 15 秒）。如果视频超出相应限制，节点将报错。
* 只要选择了 `"Disabled"` 以外的放大模型，就必须提供 `upscaler_model.upscaler_resolution`。`"FullHD (1080p)"` 以 1080p 结果为输出目标，`"4K (2160p)"` 以 2160p 结果为输出目标；实际输出宽度和高度根据输入宽高比计算，分别以最长边不超过 1920 或 3840 像素为上限，并取整为偶数。
* 当 `interpolation_model` 为 `"apo-8"` 时，必须提供 `interpolation_model.interpolation_frame_rate`。
* 当前不支持非常大的文件；上传仅限单个分片，否则节点将报错。
* 有几个参数（`sharp`、`realism`、`interpolation_slowmo`、`interpolation_duplicate`、`interpolation_duplicate_threshold`）在界面中标记为“高级”，默认情况下可能会隐藏。

## 输出

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

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

***

**Source fingerprint (SHA-256):** `14627dc772a6a46a645517bd34b545e0986a84561e24bdfe810b67f791ee47e3`