WanAnimatePlus Sampler
APG, chain guidance, RIFLEX, and the knobs the Easy node hides
- model
- image_embeds
- text_embeds
- samples
- feta_args
- context_options
- cache_args
- flowedit_args
- slg_args
- loop_args
- experimental_args
- sigmas
- unianimate_poses
- fantasytalking_embeds
- uni3c_embeds
- multitalk_embeds
- freeinit_args
- samples
- denoised_samples
Easy Sampler exists so you don't have to look at this node. WanAnimatePlus Sampler is the full settings surface for the fork's sampling engine - and if you're running Bernini or SCAIL-2, you need some of what it exposes, because the Easy node doesn't reach the guidance modes those models depend on.
The core is familiar. model, image_embeds, steps (30), cfg (6), shift (5), seed, force_offload, scheduler (unipc default, 21 choices), plus text_embeds and samples (init latents for v2v) with denoise_strength and add_noise_to_samples for controlling how much of that init survives. context_options brings in windowing for long clips. batched_cfg batches cond and uncond for speed at the cost of memory - try it on a 24GB card, skip it on a 12GB one.
The part that makes it worth it: guidance modes. guidance_mode is where Bernini lives. Options: cfg (standard), apg (single-condition APG), apg_chain (image-reference APG chain), and cfg_chain (Bernini chained CFG). APG - adaptive parallel guidance - is the modern replacement for plain CFG, and the fork implements it with a full parameter set: apg_eta (parallel/orthogonal balance, 0.5 default), apg_momentum, apg_norm_threshold (L2 clipping, 50 default), and three omega values (apg_omega, apg_omega_I, apg_omega_TI) plus chain omegas (chain_omega_V, chain_omega_I, chain_omega_TI). The Bernini node literally outputs a recommended_guidance string telling you which of these to set per task - r2v wants apg_chain with apg_omega_I=4.5/apg_omega_TI=4.0, rv2v wants cfg_chain with the chain omegas. Defaults are sensible; follow the cheat-sheet.
Long-form and loop tools. riflex_freq_index (0 = disabled, default 6 when on) is RIFLEX - it lets new frames generate after the clip without looping back, which is the anti-repetition tool for extended takes. loop_args (from a loop-args node) handles loop-mode chunking. start_step/end_step slice the sampling schedule for two-stage tricks, and rope_function (comfy default) picks a compilable RoPE implementation - comfy_chunked trades some peak VRAM. The remaining inputs (feta_args, cache_args, slg_args, experimental_args, sigmas, unianimate_poses, fantasytalking_embeds, uni3c_embeds, multitalk_embeds, freeinit_args) are all optional bundles for specific models; ignore what you don't use. (flowedit_args is there but its tooltip is blunt: "FlowEdit support has been deprecated.")
Outputs. samples (latents for WanAnimatePlus Decode) and denoised_samples (pre-VAE denoised output).
Install via ComfyUI Manager (search "WanAnimatePlus") or git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus into custom_nodes, restart. Start on Easy Sampler if you're on plain Wan Animate; graduate here the day a Bernini or SCAIL-2 workflow needs apg_chain. The fork-wide chain rule applies - and when CFG 6 with a speed LoRA gives you melted output, remember the distilled-model rule: CFG toward 1.0.
Inputs (40)
| Name | Type | Default | Description |
|---|---|---|---|
| model | WANVIDEOMODEL | — | |
| image_embeds | WANVIDIMAGE_EMBEDS | — | |
| steps | INT | 30 | — |
| cfg | FLOAT | 6.000–30 | — |
| shift | FLOAT | 5.000–1000 | — |
| seed | INT | 00–18446744073709550000 | — |
| force_offload | BOOLEAN | true | Moves the model to the offload device after sampling |
| scheduler | COMBO | unipc | 21 options: unipc, unipc/beta, dpm++, dpm++/beta, dpm++_sde, dpm++_sde/beta, +15 |
| riflex_freq_index | INT | 00–1000 | Frequency index for RIFLEX, disabled when 0, default 6. Allows for new frames to be generated after without looping |
| text_embedsopt | WANVIDEOTEXTEMBEDS | — | |
| samplesopt | LATENT | init Latents to use for video2video process | |
| denoise_strengthopt | FLOAT | 1.000–1 | — |
| feta_argsopt | FETAARGS | — | |
| context_optionsopt | WANVIDCONTEXT | — | |
| cache_argsopt | CACHEARGS | — | |
| flowedit_argsopt | FLOWEDITARGS | FlowEdit support has been deprecated | |
| batched_cfgopt | BOOLEAN | false | Batch cond and uncond for faster sampling, possibly faster on some hardware, uses more memory |
| slg_argsopt | SLGARGS | — | |
| rope_functionopt | COMBO | comfy | Comfy's RoPE implementation doesn't use complex numbers and can thus be compiled, that should be a lot faster when using torch.compile. Chunked version has reduced peak VRAM usage when not using torch.compile |
| loop_argsopt | LOOPARGS | — | |
| experimental_argsopt | EXPERIMENTALARGS | — | |
| sigmasopt | SIGMAS | — | |
| unianimate_posesopt | UNIANIMATE_POSE | — | |
| fantasytalking_embedsopt | FANTASYTALKING_EMBEDS | — | |
| uni3c_embedsopt | UNI3C_EMBEDS | — | |
| multitalk_embedsopt | MULTITALK_EMBEDS | — | |
| freeinit_argsopt | FREEINITARGS | — | |
| start_stepopt | INT | 00–10000 | Start step for the sampling, 0 means full sampling, otherwise samples only from this step |
| end_stepopt | INT | -1-1–10000 | End step for the sampling, -1 means full sampling, otherwise samples only until this step |
| add_noise_to_samplesopt | BOOLEAN | false | Add noise to the samples before sampling, needed for video2video sampling when starting from clean video |
| guidance_modeopt | COMBO | cfg | Guidance mode: cfg (standard CFG), apg (single-condition APG), apg_chain (image-reference APG chain), or cfg_chain (Bernini chained CFG) |
| apg_etaopt | FLOAT | 0.500–1 | APG: parallel/orthogonal balance (0=orthogonal only, 1=full) |
| apg_momentumopt | FLOAT | 0.00-1–1 | APG: EMA momentum for smoothing guidance differences |
| apg_norm_thresholdopt | FLOAT | 500–1000 | APG: L2 norm clipping threshold (0=disabled) |
| apg_omegaopt | FLOAT | 4.000–30 | APG: guidance strength (equivalent to CFG scale, replaces cfg when APG is active) |
| apg_omega_Iopt | FLOAT | 4.500–30 | APG chain: image-only guidance strength |
| apg_omega_TIopt | FLOAT | 4.000–30 | APG chain: text+image guidance strength |
| chain_omega_Vopt | FLOAT | 1.250–30 | Chain CFG: video-only guidance strength |
| chain_omega_Iopt | FLOAT | 4.500–30 | Chain CFG: extra reference context strength (VI - V; reference video/images) |
| chain_omega_TIopt | FLOAT | 4.000–30 | Chain CFG: text+image guidance strength |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| samples | LATENT | — |
| denoised_samples | LATENT | — |