# HunyuanVideo Workflow Recipe

Use this when you want a local HunyuanVideo workflow in ComfyUI.

## What to use

- a known-good HunyuanVideo text-to-video ComfyUI workflow saved in API format
- the exact model files required by that workflow

## Where to put the model

For most HunyuanVideo workflows:

- put the main video model in `ComfyUI/models/diffusion_models/`
- place any matching text encoders, VAE, and helper files in the folders your workflow expects

## What to set in the app

1. Set `Engine` to `comfyui`
2. Set `Mode` to `video`
3. Set `Preset` to `HunyuanVideo`
4. Set `Server URL` to your local ComfyUI server
5. Pick your saved API-format HunyuanVideo workflow JSON
6. Set `Expected Output` to match your save node, usually `mp4` or `webm`
7. Click `Refresh Models`
8. Choose `diffusion_models`
9. Pick the HunyuanVideo model in `Model Override`

## Recommended node fields

For a normal HunyuanVideo graph:

- `Model Node`: the main model loader node, often `UNETLoader` or a workflow-specific model loader
- `Model Input`: usually `model_name`
- `Prompt Node`: the positive text node for the prompt
- `Prompt Input`: `text`
- `Negative Prompt Node`: the negative text node if the workflow has one
- `Negative Prompt Input`: `text`

If titles differ:

- use the exact node ids from your workflow instead

## Practical defaults

- test a single prompt directly in ComfyUI before batching
- expect heavier GPU and memory demands than Wan
- keep the workflow's own size, frame count, sampler, and save node at first
- once one clip works, the app can handle batching, filenames, manifest, and retry flow

## Important note

This preset is mainly about organization and batching.

The workflow still owns:

- model graph details
- text encoder wiring
- VAE
- frame count
- resolution
- sampler
- save node

That is especially important for HunyuanVideo, because local setups vary a lot more here than with SDXL.
