> ## 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.

# MiniMaxH3FunControlNetApply - ComfyUI Built-in Node Documentation

> 此节点将一个 MiniMax H3 Fun ControlNet 作为模型补丁应用于文本生成视频模型。

此节点将一个 MiniMax H3 Fun ControlNet 作为模型补丁应用于文本生成视频模型。它可以使用可选的引导视频和可选遮罩来控制生成过程，并返回打了补丁的模型副本以供后续采样。当 `strength` 设为 0，或未提供引导视频与遮罩时，将原样返回输入模型。

## 输入

| 参数              | 描述                                                                 | 数据类型         | 必需 | 范围                       |
| --------------- | ------------------------------------------------------------------ | ------------ | -- | ------------------------ |
| `model`         | 将要应用 MiniMax H3 Fun ControlNet 补丁的扩散模型。                            | MODEL        | 是  | N/A                      |
| `model_patch`   | MiniMax H3 Fun ControlNet 补丁，其控制信号注入到模型中；它必须与给定的 `model` 兼容。       | MODEL\_PATCH | 是  | N/A                      |
| `vae`           | 用于将控制帧和源视频帧编码为模型所期望的潜在空间的 VAE。                                     | VAE          | 是  | N/A                      |
| `strength`      | ControlNet 效果的总体强度。当设为 0 时，节点不执行操作并原样返回输入模型。（默认值：1.0）              | FLOAT        | 是  | 最小值 0.0，最大值 10.0，步长 0.01 |
| `start_percent` | ControlNet 处于激活状态的采样范围起点，以采样进度的百分比表示。内部会将其转换为对应的 sigma 值。（默认值：0.0） | FLOAT        | 是  | 最小值 0.0，最大值 1.0，步长 0.001 |
| `end_percent`   | ControlNet 处于激活状态的采样范围终点，以采样进度的百分比表示。内部会将其转换为对应的 sigma 值。（默认值：1.0） | FLOAT        | 是  | 最小值 0.0，最大值 1.0，步长 0.001 |
| `control_video` | 用作 ControlNet 视觉提示的可选视频帧。这些帧会被调整大小以匹配生成的视频，并使用 `vae` 进行编码。         | IMAGE        | 否  | N/A                      |
| `mask`          | 值为 1 表示需要重新生成的区域。遮罩值大于 0.5 的部分会被视为标记区域。                            | MASK         | 否  | N/A                      |
| `source_video`  | 遮罩背后的视频；仅在提供遮罩时才读取。                                                | IMAGE        | 否  | N/A                      |

注意：要使补丁生效，`strength` 必须大于 0，并且 `control_video` 和 `mask` 至少提供其中一个。未提供 `mask` 时，`source_video` 会被忽略；如果提供了 `mask` 但没有提供 `source_video`，遮罩区域背后的内容将按黑色处理。

## 输出

| 输出名称    | 描述                                                                               | 数据类型  |
| ------- | -------------------------------------------------------------------------------- | ----- |
| `model` | 已应用 MiniMax H3 Fun ControlNet 的输入模型补丁副本。如果 `strength` 为 0，或未提供引导视频与遮罩，则原样返回原始模型。 | MODEL |

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

***

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