KlingVideoNode - ComfyUI Built-in Node Documentation

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

This node generates videos using the Kling V3 model. It supports text-to-video mode, where a video is created from a text description, and image-to-video mode, where an existing image is animated. It also offers advanced features like creating multi-segment videos with individual prompts for each part (storyboards) and optionally generating accompanying audio.

Inputs

Parameter	Description	Data Type	Required	Range
multi_shot	Controls whether to generate a single video or a series of segments with individual prompts and durations. When not “disabled,” additional inputs for each storyboard’s prompt and duration appear.	COMBO	Yes	"disabled" "1 storyboard" "2 storyboards" "3 storyboards" "4 storyboards" "5 storyboards" "6 storyboards"
generate_audio	When enabled, the node will generate audio for the video. Default is True.	BOOLEAN	Yes	True / False
model	The model and its associated settings. Selecting this option reveals the resolution and aspect_ratio sub-parameters.	COMBO	Yes	"kling-v3"
model.resolution	The resolution for the generated video.	COMBO	Yes	"4k" "1080p" "720p"
model.aspect_ratio	The aspect ratio for the generated video. This setting is ignored when an image is provided for start_frame (image-to-video mode).	COMBO	Yes	"16:9" "9:16" "1:1"
seed	A seed value for generation. Changing this value will cause the node to re-run, but results are non-deterministic regardless of seed. Default is 0.	INT	Yes	0 to 2147483647
start_frame	Optional start frame image. When connected, switches to image-to-video mode.	IMAGE	No	-

Inputs for multi_shot mode:

• When multi_shot is set to “disabled”, the following inputs appear:
  • prompt (STRING): The main text description for the video. Must be between 1 and 2500 characters.
  • negative_prompt (STRING): Text describing what should not appear in the video.
  • duration (INT): The length of the video in seconds. Must be between 3 and 15. Default is 5.
• When multi_shot is set to a storyboard option (e.g., "3 storyboards"), inputs for each storyboard segment appear (e.g., storyboard_1_prompt, storyboard_1_duration). Each storyboard prompt must be between 1 and 512 characters. The total sum of all storyboard durations must be between 3 and 15 seconds.

Constraints:

• The node operates in text-to-video mode when start_frame is not connected. It uses the model.aspect_ratio setting in this mode.
• The node operates in image-to-video mode when start_frame is connected. The model.aspect_ratio setting is ignored. The input image must be at least 300x300 pixels and have an aspect ratio between 1:2.5 and 2.5:1.
• In storyboard mode (multi_shot not “disabled”), the main prompt and negative_prompt inputs are hidden and not used.

Outputs

Output Name	Description	Data Type
video	The generated video file.	VIDEO

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

---

Source fingerprint (SHA-256): 62a336f957836693fbcfbc097fe909e3efbceaf77102c960e00dc890ba9b5757