Nodes/HunyuanVideo-1.5 nodes/HunyuanVideo 1.5 Leo Text-to-Video Sampler
ComfyUI Node

HunyuanVideo 1.5 Leo Text-to-Video Sampler

HunyuanVideo 1.5 from a text prompt, in one node

By yuanyuan-spec·Created 10 months ago·Updated 10 months ago· 28
HunyuanVideo 1.5 Leo Text-to-Video Sampler
  • hunyuanvideo_model_config
  • IMAGE
promptA close-up shot captures a scene on a polished, light-colored granite kitchen counter, illuminated by soft natural light from an unseen window. Initially, the frame focuses on a tall, clear glass filled with golden, translucent apple juice standing next to a single, shiny red apple with a green leaf still attached to its stem. The camera moves horizontally to the right. As the shot progresses, a white ceramic plate smoothly enters the frame, revealing a fresh arrangement of about seven or eight more apples, a mix of vibrant reds and greens, piled neatly upon it. A shallow depth of field keeps the focus sharply on the fruit and glass, while the kitchen backsplash in the background remains softly blurred. The scene is in a realistic style.
negative_prompt
video_length121
num_inference_steps50
guidance_scale6.00
num_videos_per_prompt1
output_typept
create_sr_pipelinetrue
aspect_ratio16:9
sr_num_inference_steps8
prompt_rewritefalse
prompt_rewrite_base_url
prompt_rewrite_model_name
seed0
enable_cachefalse
cache_start_step11
cache_end_step45
no_cache_block_id53
cache_step_interval4
cache_typedeepcache
enable_sageattnfalse

HyVideo15T2VSampler is the text-to-video half of the simplified node set: load the model, type a prompt, get a clip. Same shape as its I2V sibling but no reference image - the model has to invent the whole scene from text. It's a two-node workflow with HyVideo15ModelLoader and it's the fastest way to test whether this pack (and the 1.5 model) is for you.

What it does

One node wrapping the whole pipeline - text encoder, transformer, scheduler, and the SR pass - plus the denoising loop. The settings you'll touch:

  • hunyuanvideo_model_config - from HyVideo15ModelLoader. Set task to t2v there and match resolution (480p/720p).
  • prompt / negative_prompt - write for motion and camera ("slow dolly-in", "camera pans right"), not just subject description. That's what separates a video prompt from an image prompt.
  • video_length (121) - frames, ~7.5s at 16fps.
  • num_inference_steps (50) / guidance_scale (6) - the base-model defaults. If you're on a distilled _distilled variant, drop steps to 8–12.
  • aspect_ratio (16:9) - mapped to the nearest supported bucket.
  • create_sr_pipeline (true) / sr_num_inference_steps (8) - the distilled 720p/1080p upscale pass. Real quality win; disable only for VRAM.
  • prompt_rewrite + prompt_rewrite_base_url / prompt_rewrite_model_name - 1.5's prompt-rewrite feature, which sends your prompt to an OpenAI-compatible LLM endpoint for enrichment. The sampler only enables it when you give it a base_url and model name (it reads them via env vars), so with no endpoint configured, leave it off.

Same speed options as the I2V sampler: enable_cache (deepcache / teacache / taylorcache, needs angelslim==0.2.1) and enable_sageattn. Output is IMAGE (or raw latent if you set output_type to that).

The honest take

T2V is not where HunyuanVideo 1.5 wins. Community consensus across 2025–26 was consistently that 1.5's text-to-video underperforms its image-to-video, and that prompt adherence in T2V is the weak point - the distilled demo that got people excited was an I2V clip, and the model's reputation was built on I2V. If you primarily generate from text, Wan 2.2 or LTX are the stronger picks in the current landscape. If you're here anyway, keep expectations calibrated: give it a descriptive motion prompt and use the SR pass, because that's where 1.5's cinematic look shows up.

Installing it

ComfyUI Manager → "HunyuanVideo-1.5 nodes", or:

cd ComfyUI/custom_nodes
git clone https://github.com/yuanyuan-spec/comfyui_hunyuanvideo_1.5_plugin
cd comfyui_hunyuanvideo_1.5_plugin
pip install -r requirements.txt

Restart, then let HyVideo15ModelLoader auto-download (or point it at a manual model folder). That first download is huge - transformer, 7B text encoder, VAE, vision encoder, byT5.

Common issues

Same first-run pains as the I2V path: OOM (fix: enable_offloading in the loader, drop to 480p, disable SR), and the gated FLUX.1-Redux-dev vision encoder download failing (fix: HF token in the loader). One sampler-specific gotcha: negative_prompt defaults to empty here, so if your results come out noisy or unfocused, add the standard Hunyuan negative ("Aerial view, overexposed, low quality, deformation...") - the CFG node in the complete workflow ships with a good one you can copy.

CategoryHunyuanVideoWrapper1.5

Inputs (22)

NameTypeDefaultDescription
hunyuanvideo_model_configHUNYUANVIDEO_MODEL_CONFIG
promptSTRINGA close-up shot captures a scene on a polished, light-colored granite kitchen counter, illuminated by soft natural light from an unseen window. Initially, the frame focuses on a tall, clear glass filled with golden, translucent apple juice standing next to a single, shiny red apple with a green leaf still attached to its stem. The camera moves horizontally to the right. As the shot progresses, a white ceramic plate smoothly enters the frame, revealing a fresh arrangement of about seven or eight more apples, a mix of vibrant reds and greens, piled neatly upon it. A shallow depth of field keeps the focus sharply on the fruit and glass, while the kitchen backsplash in the background remains softly blurred. The scene is in a realistic style.
negative_promptSTRING
video_lengthINT121
num_inference_stepsINT50
guidance_scaleFLOAT6.00
num_videos_per_promptINT1
output_typeSTRINGpt
create_sr_pipelineBOOLEANtrue
aspect_ratioSTRING16:9
sr_num_inference_stepsINT8
prompt_rewriteBOOLEANfalseRewrite prompt.
prompt_rewrite_base_urlSTRING
prompt_rewrite_model_nameSTRING
seedoptINT0
enable_cacheoptBOOLEANfalseEnable cache.
cache_start_stepoptINT11Cache start step.
cache_end_stepoptINT45Cache end step.
no_cache_block_idoptINT53No cache block id.
cache_step_intervaloptINT4Cache step interval.
cache_typeoptCOMBOdeepcacheCache type.
enable_sageattnoptBOOLEANfalseEnable sageattn.

Outputs (1)

NameTypeDescription
IMAGEIMAGE