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

# KlingVideoNode - ComfyUI Built-in Node Documentation

> 此节点使用 Kling V3 模型生成视频。

此节点使用 Kling V3 模型生成视频。它支持文本转视频模式（根据文本描述创建视频）和图像转视频模式（将现有图像动画化）。它还具有高级功能，例如创建多个视频片段，并为每个部分（故事板）设置单独的提示词，以及可选地生成伴随音频。

## 输入

### 通用输入

| 参数     | 描述                                                                   | 数据类型           | 必需 | 范围                                                                                                                                                    |
| ------ | -------------------------------------------------------------------- | -------------- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `多镜头`  | 生成一系列具有单独提示词和时长的视频片段。当设置为故事板选项时，会为每个故事板的提示词和时长显示额外输入。                | DYNAMIC\_COMBO | 是  | `"disabled"`<br />`"1 storyboard"`<br />`"2 storyboards"`<br />`"3 storyboards"`<br />`"4 storyboards"`<br />`"5 storyboards"`<br />`"6 storyboards"` |
| `模型`   | 模型和生成设置。选择模型后会显示其分辨率和宽高比子参数。                                         | DYNAMIC\_COMBO | 是  | `"kling-v3"`<br />`"kling-3.0-turbo"`                                                                                                                 |
| `生成音频` | 启用后，节点将为视频生成音频。注意：`"kling-3.0-turbo"` 始终生成原生音频，因此该开关对此模型无效。默认为 True。 | BOOLEAN        | 是  | True<br />False                                                                                                                                       |
| `seed` | 种子控制节点是否应重新运行；无论种子如何，结果都是非确定性的。默认为 0。                                | INT            | 是  | 0 到 2147483647                                                                                                                                        |
| `起始帧`  | 可选的起始帧图像。连接后，将切换到图像转视频模式。                                            | IMAGE          | 否  | -                                                                                                                                                     |

### kling-v3 输入

| 参数    | 描述                      | 数据类型  | 必需 | 范围                                  |
| ----- | ----------------------- | ----- | -- | ----------------------------------- |
| `分辨率` | 生成视频的分辨率。默认为 `"1080p"`。 | COMBO | 是  | `"4k"`<br />`"1080p"`<br />`"720p"` |
| `宽高比` | 生成视频的宽高比。在图像转视频模式下忽略。   | COMBO | 是  | `"16:9"`<br />`"9:16"`<br />`"1:1"` |

### kling-3.0-turbo 输入

| 参数    | 描述                     | 数据类型  | 必需 | 范围                                  |
| ----- | ---------------------- | ----- | -- | ----------------------------------- |
| `分辨率` | 生成视频的分辨率。默认为 `"720p"`。 | COMBO | 是  | `"1080p"`<br />`"720p"`             |
| `宽高比` | 生成视频的宽高比。在图像转视频模式下忽略。  | COMBO | 是  | `"16:9"`<br />`"9:16"`<br />`"1:1"` |

### 多镜头输入

**当 `multi_shot` 设置为 `"disabled"` 时：**

| 参数                | 描述                            | 数据类型   | 必需 | 范围           |
| ----------------- | ----------------------------- | ------ | -- | ------------ |
| `prompt`          | 视频的主要文本描述。必须在 1 到 2500 个字符之间。 | STRING | 是  | 1 到 2500 个字符 |
| `negative_prompt` | 描述视频中不应出现内容的文本。可以为空。          | STRING | 否  | -            |
| `duration`        | 视频的时长（秒）。默认为 5。               | INT    | 是  | 3 到 15       |

**当 `multi_shot` 设置为故事板选项（例如 `"3 storyboards"`）时：**

对于每个故事板片段 N（从 1 到所选故事板数量），会显示以下输入：

| 参数                      | 描述                       | 数据类型   | 必需 | 范围          |
| ----------------------- | ------------------------ | ------ | -- | ----------- |
| `storyboard_N_prompt`   | 故事板片段 N 的提示词。最多 512 个字符。 | STRING | 是  | 1 到 512 个字符 |
| `storyboard_N_duration` | 故事板片段 N 的时长（秒）。默认为 4。    | INT    | 是  | 1 到 15      |

**约束和行为：**

* 当未连接 `start_frame` 时使用文本转视频模式；当连接 `start_frame` 时使用图像转视频模式。在图像转视频模式下，`model.aspect_ratio` 被忽略，输入图像必须至少为 300x300 像素，且宽高比在 1:2.5 到 2.5:1 之间。
* 在故事板模式下，主 `prompt` 和 `negative_prompt` 不适用。所有故事板时长的总和必须在 3 到 15 秒之间。
* `negative_prompt` 仅与 `kling-v3` 一起使用；当选择 `kling-3.0-turbo` 时会被忽略。
* 对于 `kling-v3`，每个故事板作为单独的片段发送到 API。对于 `kling-3.0-turbo`，故事板的提示词和时长会被合并为一个多镜头提示。
* 对于 `kling-3.0-turbo`，`generate_audio` 被忽略，因为该模型始终生成原生音频。

## 输出

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

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

***

**Source fingerprint (SHA-256):** `2863d7a971a1978b6009e5321ed2112a9c04809281acd5f65d85ab72c4b49f08`