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

# KlingMotionControl - ComfyUI Built-in Node Documentation

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

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

Kling Motion Control 节点通过将参考视频中的动作、表情和摄像机运动应用到由参考图像和文本提示定义的角色上，从而生成视频。它允许您控制角色的最终朝向是来自参考视频还是参考图像。

## 输入参数

| 参数                      | 数据类型    | 必填 | 取值范围                     | 描述                                                                                         |
| ----------------------- | ------- | -- | ------------------------ | ------------------------------------------------------------------------------------------ |
| `prompt`                | STRING  | 是  | N/A                      | 对期望视频的文本描述。最大长度为 2500 个字符。                                                                 |
| `reference_image`       | IMAGE   | 是  | N/A                      | 要动画化的角色图像。最小尺寸为 340x340 像素。宽高比必须在 1:2.5 到 2.5:1 之间。                                        |
| `reference_video`       | VIDEO   | 是  | N/A                      | 用于驱动角色运动和表情的运动参考视频。最小尺寸为 340x340 像素，最大尺寸为 3850x3850 像素。时长限制取决于 `character_orientation` 设置。 |
| `keep_original_sound`   | BOOLEAN | 否  | N/A                      | 决定是否在输出中保留参考视频的原始音频。默认值为 `True`。                                                           |
| `character_orientation` | COMBO   | 否  | `"video"`<br />`"image"` | 控制角色的朝向/方向来源。`"video"`：运动、表情、摄像机移动和朝向均遵循运动参考视频。`"image"`：运动和表情遵循运动参考视频，但角色朝向与参考图像匹配。       |
| `mode`                  | COMBO   | 否  | `"pro"`<br />`"std"`     | 要使用的生成模式。                                                                                  |

**约束条件：**

* 当 `character_orientation` 设置为 `"video"` 时，`reference_video` 的时长必须在 3 到 30 秒之间。
* 当 `character_orientation` 设置为 `"image"` 时，`reference_video` 的时长必须在 3 到 10 秒之间。

## 输出结果

| 输出名称     | 数据类型  | 描述                    |
| -------- | ----- | --------------------- |
| `output` | VIDEO | 生成的视频，其中角色执行参考视频中的动作。 |
