ComfyUI > Nodes > ComfyUI-HunyuanVideoWrapper > HunyuanVideo Latent Preview

ComfyUI Node: HunyuanVideo Latent Preview

Class Name

HyVideoLatentPreview

Category
HunyuanVideoWrapper
Author
kijai (Account age: 2506days)
Extension
ComfyUI-HunyuanVideoWrapper
Latest Updated
2025-05-12
Github Stars
2.4K

How to Install ComfyUI-HunyuanVideoWrapper

Install this extension via the ComfyUI Manager by searching for ComfyUI-HunyuanVideoWrapper
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-HunyuanVideoWrapper in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

HunyuanVideo Latent Preview Description

Visualize latent video data for AI art creation, bridging abstract space to tangible output for real-time parameter tuning and creative exploration.

HunyuanVideo Latent Preview:

The HyVideoLatentPreview node is designed to provide a visual representation of latent video data, which is crucial for understanding and refining the video generation process in AI art creation. This node serves as a bridge between the abstract latent space and the more tangible visual output, allowing you to preview how changes in the latent variables affect the final video. By offering a preview of the latent space, it helps in fine-tuning the parameters and understanding the underlying structure of the generated video content. This capability is particularly beneficial for artists and creators who wish to experiment with different latent configurations and observe their impact in real-time, thus enhancing the creative process and ensuring the desired artistic outcomes.

HunyuanVideo Latent Preview Input Parameters:

model

This parameter specifies the model to be used for generating the latent preview. It is crucial as it determines the architecture and capabilities of the video generation process. The model should be compatible with the HunyuanVideo framework to ensure accurate previews.

hyvid_embeds

These are the embeddings used in the video generation process. They play a significant role in defining the characteristics and features of the generated video. The embeddings should be carefully selected to match the desired style and content of the video.

samples

This parameter refers to the initial latent samples used for the video2video process. It acts as a starting point for generating the video preview and can significantly influence the outcome. The samples should be chosen based on the intended video style and content.

inversed_latents

These are the latents obtained from the HyVideoInverseSampler. They are used to refine the video generation process by providing additional context and guidance. The inversed latents help in achieving more accurate and realistic video previews.

steps

This integer parameter defines the number of steps for the video generation process. It controls the granularity and detail of the preview, with a default value of 30 and a minimum of 1. Adjusting the steps can help in balancing the quality and speed of the preview generation.

embedded_guidance_scale

A float parameter that determines the strength of the guidance provided by the embeddings, with a default value of 6.0. It ranges from 0.0 to 30.0, allowing you to control the influence of the embeddings on the video preview. A higher value results in stronger guidance.

flow_shift

This float parameter, with a default value of 1.0, controls the flow shift in the video generation process. It ranges from 1.0 to 30.0 and affects the smoothness and continuity of the video preview. Adjusting this parameter can help in achieving the desired flow characteristics.

force_offload

A boolean parameter that, when set to true, forces the offloading of certain processes to optimize performance. This can be useful in managing computational resources and ensuring smooth operation during the preview generation.

start_step

An integer parameter that specifies the step at which the effect of the inversed latents begins, with a default value of 0. It helps in controlling the timing and impact of the inversed latents on the video preview.

end_step

This integer parameter defines the step at which the effect of the inversed latents ends, with a default value of 18. It allows you to control the duration of the inversed latents' influence on the video preview.

eta_base

A float parameter that sets the base value of eta, which determines the overall strength of the effect from the inversed latents. It ranges from 0.0 to 1.0, with a default value of 0.5, and helps in fine-tuning the impact of the inversed latents.

eta_trend

This parameter offers options for the trend of the eta value over steps, including 'constant', 'linear_increase', and 'linear_decrease'. It allows you to control how the eta value changes throughout the video generation process, providing flexibility in shaping the preview.

HunyuanVideo Latent Preview Output Parameters:

samples

The output parameter samples provides the generated latent video preview. This preview is a visual representation of the latent space, allowing you to see how the input parameters and configurations affect the final video. It is essential for evaluating and refining the video generation process, ensuring that the desired artistic outcomes are achieved.

HunyuanVideo Latent Preview Usage Tips:

  • Experiment with different hyvid_embeds to see how they influence the style and content of the video preview. This can help in achieving the desired artistic effect.
  • Adjust the steps parameter to balance the quality and speed of the preview generation. More steps can lead to a more detailed preview, but may require more computational resources.
  • Use the eta_trend parameter to control the progression of the eta value, which can help in achieving specific effects or transitions in the video preview.

HunyuanVideo Latent Preview Common Errors and Solutions:

Model not compatible

  • Explanation: The selected model is not compatible with the HunyuanVideo framework.
  • Solution: Ensure that the model is designed to work with the HunyuanVideo system and is properly configured.

Invalid hyvid_embeds

  • Explanation: The provided embeddings are not valid or do not match the expected format.
  • Solution: Verify that the embeddings are correctly formatted and compatible with the video generation process.

Insufficient computational resources

  • Explanation: The system does not have enough resources to generate the preview with the current settings.
  • Solution: Reduce the number of steps or adjust other parameters to lower the computational load, or upgrade the system resources.

HunyuanVideo Latent Preview Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-HunyuanVideoWrapper
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Playground, enabling artists to harness the latest AI tools to create incredible art.