Wan 2.6 Reference-to-Video (fal)

Worth knowing before anything else: Wan 2.6 has no open weights. The open Wan line froze at 2.2 in July 2025 - everything from 2.5 onward (2.5, 2.6, 2.7) shipped API-only, and Alibaba never released the checkpoints. So unlike the Wan 2.2 nodes in this pack, this isn't a convenience wrapper around something you could also run locally. Calling the API is the only way to touch Wan 2.6, and this node is one of those doors. It composes a video from multiple reference videos via fal.ai.

Cloud call, per-clip billing, nothing local - and here that's not a trade-off you're choosing, it's the only option the model offers.

How it works

You supply one to three reference video URLs and a prompt that refers to them by tag - the default prompt, Dance battle between @Video1 and @Video2., shows the syntax. @Video1 points at video1_url, @Video2 at video2_url, and so on. Wan 2.6 reads the subjects/motion from those references and generates a new clip that combines them the way your prompt describes. It's a multi-reference director's chair: pull people or elements out of several clips and stage them together in one shot.

The inputs and outputs that matter

• prompt (required, multiline) - reference your inputs with @Video1/@Video2/@Video3 and describe what they do together.
• video1_url (required, STRING) - the first reference, as a fal URL. Local clips need to go through UploadVideo_fal first to become URLs.
• video2_url, video3_url (optional) - additional references.
• resolution (720p / 1080p, default 1080p), duration (5 / 10), aspect_ratio (16:9 default, plus 9:16, 1:1, 4:3, 3:4).
• enable_prompt_expansion (default on) - lets the model elaborate your prompt; helpful for short prompts, turn off if you want it to follow your wording literally.
• multi_shots (default on) - allow multiple shots/cuts in the output.

Also: negative_prompt (sensible default provided), seed (-1 = random), enable_safety_checker.

Output is a STRING URL. Download with Fal Save Media from URL or chain via *_direct_url. Save before it expires.

How to install it

From gokayfem's ComfyUI-fal-API pack. ComfyUI Manager: search ComfyUI-fal-API, install, restart. Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/gokayfem/ComfyUI-fal-API.git
pip install -r ComfyUI-fal-API/requirements.txt

Add your fal key (copy config.ini.example → config.ini, paste from fal.ai/dashboard/keys, or export FAL_KEY=your_key), restart.

Common issues & troubleshooting

"Can't I just run Wan 2.6 locally?" No. There are no weights for 2.6 anywhere, and any site advertising a local Wan 2.6 (or 2.7) download is fabricated - the links are dead. The API is the only way. If you want local Wan, you're on 2.2, and this pack has the Wan 2.2 Animate and VACE nodes for that.

The @Video1 reference didn't do anything. Check that video1_url is a real fal URL (upload local clips with UploadVideo_fal) and that your prompt actually uses the @VideoN tags. The tag is how the model knows which reference you mean.

Prompt being over-interpreted. Turn off enable_prompt_expansion for literal adherence to your wording.

Output won't preview. It's a URL - download via Fal Save Media from URL.

Insufficient funds / credit lag. fal is pay-per-call and legit; top-ups have occasionally posted late. Wait for credits rather than repaying. fal errors print as text in ComfyUI.