ComfyUI Node: KIE Kling 3.0 Preflight

KIE Kling 3.0 Preflight:

The KIE_Kling3_Preflight node is designed to serve as a validation and preparation tool for the Kling 3.0 video generation process. Its primary purpose is to ensure that all inputs are correctly formatted and ready for processing before any generation credits are spent. This node allows you to upload media, validate inputs, and construct the precise JSON payload required for task creation without actually submitting the task. By using this node, you can verify the wiring and format of your inputs, ensuring that everything is in order before proceeding to the actual video generation phase. This preflight check is crucial for avoiding errors and optimizing resource usage, making it an essential step in the Kling 3.0 workflow.

KIE Kling 3.0 Preflight Input Parameters:

mode

The mode parameter determines the operational mode of the Kling 3.0 video generation process. It influences how the video content is processed and rendered. The available options for this parameter are defined in the KLING3_MODE_OPTIONS. Selecting the appropriate mode is crucial as it affects the final output's style and characteristics.

aspect_ratio

The aspect_ratio parameter specifies the width-to-height ratio of the video output. This parameter is important for ensuring that the video fits the desired display format. The options for this parameter are provided in the KLING3_ASPECT_RATIO_OPTIONS, allowing you to choose the most suitable aspect ratio for your project.

duration

The duration parameter defines the total length of the video in seconds. It is a critical parameter as it determines how long the video will run. The available options for this parameter are listed in the KLING3_DURATION_OPTIONS, providing flexibility in setting the desired video length.

multi_shots

The multi_shots parameter allows you to specify multiple shots within the video. This parameter is useful for creating complex video sequences with different scenes or perspectives. It requires a structured input that outlines each shot's details, such as duration and description.

sound

The sound parameter indicates whether sound should be included in the video. This parameter is essential for projects that require audio elements, and it can be toggled on or off depending on the project's needs.

prompt

The prompt parameter is a textual input that guides the video generation process. It provides context and instructions for the content to be created, influencing the video's theme and narrative.

shots_text

The shots_text parameter is a detailed description of the shots to be included in the video. It follows a specific format, as illustrated in the SHOTS_TEXT_PLACEHOLDER, and is crucial for defining the sequence and content of each shot.

first_frame

The first_frame parameter specifies the initial frame of the video. It is important for setting the starting point of the video sequence, especially when using elements that reference specific frames.

last_frame

The last_frame parameter defines the final frame of the video. It is used to mark the end of the video sequence, ensuring that the video concludes at the desired point.

elements

The elements parameter is a list of objects representing various elements to be included in the video. These elements can be characters, objects, or other visual components, and they play a significant role in shaping the video's content.

log

The log parameter is a boolean that determines whether logging is enabled during the preflight process. Enabling logging can be helpful for debugging and tracking the validation steps.

KIE Kling 3.0 Preflight Output Parameters:

KIE_KLING3_REQUEST

The KIE_KLING3_REQUEST output is a validated payload object that can be used for chaining into the Kling 3.0 video generation process. It contains all the necessary information and parameters required for task creation, ensuring that the inputs are correctly formatted and ready for processing.

payload_json

The payload_json output is a string representation of the exact JSON payload that would be sent to create a task. This output is useful for reviewing and verifying the payload structure before submission, allowing you to make any necessary adjustments.

notes

The notes output provides additional information or comments related to the preflight process. It can include warnings, suggestions, or other relevant details that may assist in refining the inputs or understanding the validation results.

KIE Kling 3.0 Preflight Usage Tips:

• Always review the payload_json output to ensure that the JSON structure is correct and complete before proceeding to task submission.
• Utilize the notes output to gain insights into potential issues or improvements that can be made to the input parameters.

KIE Kling 3.0 Preflight Common Errors and Solutions:

"Prompt uses @element references but no first_frame/image_urls were provided."

• Explanation: This error occurs when the prompt references elements using the @element syntax, but no corresponding first frame or image URLs are provided.
• Solution: Ensure that you connect the first_frame parameter when using elements in the prompt to provide the necessary frame or image URLs.

"At most {ELEMENT_BATCH_MAX} elements are supported in this node."

• Explanation: This error indicates that the number of elements provided exceeds the maximum allowed limit.
• Solution: Reduce the number of elements to be within the allowed limit specified by ELEMENT_BATCH_MAX.

"Prompt references unknown @elements: ..."

• Explanation: This error occurs when the prompt references elements that are not included in the provided elements list.
• Solution: Verify that all referenced elements in the prompt are included in the elements parameter and that their names match exactly.