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

# KlingVideoNode - ComfyUI Built-in Node Documentation

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

此节点使用 Kling V3 模型生成视频。它支持两种主要模式：文本转视频（根据文本描述创建视频）和图像转视频（对现有图像进行动画处理）。它还提供高级功能，例如为每个部分（分镜）使用不同提示创建多段视频，以及可选地生成配套音频。

## 输入

| 参数                   | 描述                                                                  | 数据类型    | 必填 | 范围                                                                                                                                                    |
| -------------------- | ------------------------------------------------------------------- | ------- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `多镜头`                | 控制是生成单个视频还是生成一系列具有单独提示和时长的片段。当未设置为"disabled"时，将显示每个分镜的提示和时长的额外输入。   | COMBO   | 是  | `"disabled"`<br />`"1 storyboard"`<br />`"2 storyboards"`<br />`"3 storyboards"`<br />`"4 storyboards"`<br />`"5 storyboards"`<br />`"6 storyboards"` |
| `生成音频`               | 启用后，节点将为视频生成音频。默认为 `True`。                                          | BOOLEAN | 是  | `True` / `False`                                                                                                                                      |
| `模型`                 | 模型及其相关设置。选择此选项将显示 `resolution` 和 `aspect_ratio` 子参数。                | COMBO   | 是  | `"kling-v3"`                                                                                                                                          |
| `model.resolution`   | 生成视频的分辨率。当 `模型` 设置为 "kling-v3" 时，此设置可用。                             | COMBO   | 是  | `"4k"`<br />`"1080p"`<br />`"720p"`                                                                                                                   |
| `model.aspect_ratio` | 生成视频的宽高比。当为 `起始帧` 提供图像时（图像转视频模式），此设置将被忽略。当 `模型` 设置为 "kling-v3" 时可用。 | COMBO   | 是  | `"16:9"`<br />`"9:16"`<br />`"1:1"`                                                                                                                   |
| `seed`               | 用于生成的种子值。更改此值将导致节点重新运行，但结果是非确定性的。默认为 `0`。                           | INT     | 是  | 0 到 2147483647                                                                                                                                        |
| `起始帧`                | 可选的起始图像。连接后，节点将从文本转视频模式切换到图像转视频模式，对提供的图像进行动画处理。                     | IMAGE   | 否  | -                                                                                                                                                     |

**`multi_shot` 模式的输入：**

* 当 `multi_shot` 设置为 **"disabled"** 时，将显示以下输入：
  * `prompt` (STRING)：视频的主要文本描述。必填。长度必须在 1 到 2500 个字符之间。
  * `negative_prompt` (STRING)：描述视频中不应出现内容的文本。可选。
  * `duration` (INT)：视频的时长（秒）。必须在 3 到 15 之间。默认为 `5`。
* 当 `multi_shot` 设置为某个分镜选项（例如 `"3 storyboards"`）时，将显示每个分镜片段的输入（例如 `storyboard_1_prompt`、`storyboard_1_duration`）。每个提示的长度必须在 1 到 512 个字符之间。**所有分镜时长的总和**必须在 3 到 15 秒之间。

**约束条件：**

* 当 `start_frame` 未连接时，节点以**文本转视频**模式运行。在此模式下，使用 `model.aspect_ratio` 设置。
* 当 `start_frame` 连接时，节点以**图像转视频**模式运行。`model.aspect_ratio` 设置将被忽略。输入图像必须至少为 300x300 像素，并且宽高比在 1:2.5 到 2.5:1 之间。
* 在分镜模式（`multi_shot` 未设置为 "disabled"）下，主要的 `prompt` 和 `negative_prompt` 输入将被隐藏且不使用。

## 输出

| 输出名称    | 描述       | 数据类型  |
| ------- | -------- | ----- |
| `video` | 生成的视频文件。 | VIDEO |

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

***

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