Nodes/ComfyUI-WanAnimatePlus/WanAnimatePlus Samplerv2
ComfyUI Node

WanAnimatePlus Samplerv2

Scheduler from a node, extras from a bundle, guidance on the panel

By wuwukaka·Created 4 months ago·Updated about a month ago· 409
WanAnimatePlus Samplerv2
  • model
  • image_embeds
  • scheduler
  • text_embeds
  • samples
  • extra_args
  • samples
  • denoised_samples
cfg6.00
seed0
force_offloadtrue
add_noise_to_samplesfalse
guidance_modecfg
apg_eta0.50
apg_momentum0.00
apg_norm_threshold50
apg_omega4.00
apg_omega_I4.50
apg_omega_TI4.00
chain_omega_V1.25
chain_omega_I4.50
chain_omega_TI4.00

The v1 Sampler tried to own everything - steps, shift, scheduler, twenty optional bundles - and the panel got unmanageable. Samplerv2 is the refactor: it hands the schedule to a dedicated scheduler node and the extras to a bundle node, and keeps only the guidance controls you actually tune on its own face.

What changed. The big one: steps, shift, and the scheduler enum are gone. Instead, scheduler is a WANVIDEOSCHEDULER object - produced by the pack's WanAnimatePlus Scheduler or Schedulerv2 nodes, where steps, shift and the scheduling curve actually live. Build your schedule there, feed it in here. And instead of a dozen optional embed inputs, there's a single extra_args input accepting the WANVIDSAMPLEREXTRAARGS bundle from WanAnimatePlus SamplerExtraArgs - context options, RIFLEX, cache, loop args and model embeds all ride in that one wire.

What stayed. model, image_embeds, cfg (default 6), seed, force_offload, plus text_embeds, samples (init latents for v2v) and add_noise_to_samples (needed when starting from clean video). And critically, the full guidance block: guidance_mode (cfg/apg/apg_chain/cfg_chain) with apg_eta, apg_momentum, apg_norm_threshold, apg_omega, apg_omega_I, apg_omega_TI, and chain_omega_V, chain_omega_I, chain_omega_TI. That's the whole Bernini story - rv2v editing wants cfg_chain with the chain omegas, r2v wants apg_chain - and it's all here on the panel, not buried in a bundle. Note there's no steps here because the scheduler node owns it; if you're moving from v1, re-wire your steps/shift into the scheduler or nothing changes when you drag the sliders.

When to use it. If you're building a graph with Scheduler/Schedulerv2 + SamplerExtraArgs anyway - which is the pattern this node is designed around - Samplerv2 is the clean middle of that chain: schedule in, extras in, guidance tuned, samples + denoised_samples out for WanAnimatePlus Decode. It's also the sampler that SamplerExtraArgs is explicitly built to feed. If you'd rather have steps on the same node as everything else, the v1 Sampler or Easy Sampler still do that.

Install via ComfyUI Manager (search "WanAnimatePlus") or git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus into custom_nodes, restart. Fork-wide rules apply: WanAnimatePlus chain only, and don't mix this with the original wrapper's scheduler - the WANVIDEOSCHEDULER object is the fork's own type.

CategoryWanAnimatePlus

Inputs (20)

NameTypeDefaultDescription
modelWANVIDEOMODEL
image_embedsWANVIDIMAGE_EMBEDS
cfgFLOAT6.000–30
seedINT00–18446744073709550000
force_offloadBOOLEANtrueMoves the model to the offload device after sampling
schedulerWANVIDEOSCHEDULER
text_embedsoptWANVIDEOTEXTEMBEDS
samplesoptLATENTinit Latents to use for video2video process
add_noise_to_samplesoptBOOLEANfalseAdd noise to the samples before sampling, needed for video2video sampling when starting from clean video
guidance_modeoptCOMBOcfgGuidance mode: cfg (standard CFG), apg (single-condition APG), apg_chain (image-reference APG chain), or cfg_chain (Bernini chained CFG)
apg_etaoptFLOAT0.500–1APG: parallel/orthogonal balance (0=orthogonal only, 1=full)
apg_momentumoptFLOAT0.00-1–1APG: EMA momentum for smoothing guidance differences
apg_norm_thresholdoptFLOAT500–1000APG: L2 norm clipping threshold (0=disabled)
apg_omegaoptFLOAT4.000–30APG: guidance strength
apg_omega_IoptFLOAT4.500–30APG chain: image-only guidance strength
apg_omega_TIoptFLOAT4.000–30APG chain: text+image guidance strength
chain_omega_VoptFLOAT1.250–30Chain CFG: video-only guidance strength
chain_omega_IoptFLOAT4.500–30Chain CFG: extra reference context strength (VI - V; reference video/images)
chain_omega_TIoptFLOAT4.000–30Chain CFG: text+image guidance strength
extra_argsoptWANVIDSAMPLEREXTRAARGS

Outputs (2)

NameTypeDescription
samplesLATENT
denoised_samplesLATENT