HunyuanVideo 1.5 Leo Text-to-Video Sampler
HunyuanVideo 1.5 from a text prompt, in one node
- hunyuanvideo_model_config
- IMAGE
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. Settasktot2vthere and matchresolution(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
_distilledvariant, 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_urland 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.
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| hunyuanvideo_model_config | HUNYUANVIDEO_MODEL_CONFIG | — | |
| prompt | STRING | A 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 | STRING | — | |
| video_length | INT | 121 | — |
| num_inference_steps | INT | 50 | — |
| guidance_scale | FLOAT | 6.00 | — |
| num_videos_per_prompt | INT | 1 | — |
| output_type | STRING | pt | — |
| create_sr_pipeline | BOOLEAN | true | — |
| aspect_ratio | STRING | 16:9 | — |
| sr_num_inference_steps | INT | 8 | — |
| prompt_rewrite | BOOLEAN | false | Rewrite prompt. |
| prompt_rewrite_base_url | STRING | — | |
| prompt_rewrite_model_name | STRING | — | |
| seedopt | INT | 0 | — |
| enable_cacheopt | BOOLEAN | false | Enable cache. |
| cache_start_stepopt | INT | 11 | Cache start step. |
| cache_end_stepopt | INT | 45 | Cache end step. |
| no_cache_block_idopt | INT | 53 | No cache block id. |
| cache_step_intervalopt | INT | 4 | Cache step interval. |
| cache_typeopt | COMBO | deepcache | Cache type. |
| enable_sageattnopt | BOOLEAN | false | Enable sageattn. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| IMAGE | IMAGE | — |