> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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"` |
| `生成音频` | 启用时，节点会为视频生成音频。注意：`"kling-3.0-turbo"` 始终生成原生音频，因此该模型会忽略音频开关。默认为 True。 | BOOLEAN | 是 | True<br />False |
| `模型` | 模型和生成设置。选择模型后会显示其分辨率和宽高比子参数。 | DYNAMIC\_COMBO | 是 | `"kling-v3"`<br />`"kling-3.0-turbo"` |
| `seed` | `seed` 控制节点是否应重新运行；无论 `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 characters |
| `negative_prompt` | 描述视频中不应出现内容的文本。可以留空。 | STRING | 否 | - |
| `duration` | 视频长度，以秒为单位。默认为 5。 | INT | 是 | 3 到 15 |

**当 `multi_shot` 设置为某个分镜选项时（例如 `"3 storyboards"`）：**

对于每个分镜片段 N（从 1 到所选分镜数量），会出现以下输入：

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `storyboard_N_prompt` | 分镜片段 N 的提示词。最多 512 个字符。 | STRING | 是 | 1 到 512 characters |
| `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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.