Files
2026-06-28 09:11:35 -05:00

230 lines
10 KiB
Python

import torch
from comfy_api.latest import io
class WanVACEPrepBase:
@staticmethod
def _validate_dimensions(video_1, video_2):
"""Validate that both videos have matching, 16-divisible dimensions."""
height = video_1.shape[1]
width = video_1.shape[2]
if video_2.shape[1] != height or video_2.shape[2] != width:
raise ValueError(
f"Video dimensions must match. "
f"video_1 is {width}x{height}, "
f"video_2 is {video_2.shape[2]}x{video_2.shape[1]}"
)
if width % 16 != 0 or height % 16 != 0:
raise ValueError(
f"Video dimensions must be divisible by 16. "
f"Current dimensions: {width}x{height}"
)
return width, height
@staticmethod
def _extract_context(video_1, video_2, context_frames, replace_frames):
"""Extract context frames from each video edge for the control video."""
if replace_frames > 0:
v1_context = video_1[-(context_frames + replace_frames):-replace_frames]
v2_context = video_2[replace_frames:context_frames + replace_frames]
else:
v1_context = video_1[-context_frames:]
v2_context = video_2[:context_frames]
return v1_context, v2_context
@staticmethod
def _build_control_video_and_mask(video_1, v1_context, v2_context,
context_frames, replace_frames, new_frames,
height, width):
"""Build the control video tensor and mask."""
channels = video_1.shape[3]
# Wan wants to generate 4n+1 frames. If we don't provide that,
# it will quietly round down to the nearest 4n+1. So we add 1 here.
vace_count = (replace_frames * 2) + new_frames + 1
vace_frames = torch.full(
(vace_count, height, width, channels), 0.5,
dtype=video_1.dtype, device=video_1.device
)
control_video = torch.cat([v1_context, vace_frames, v2_context], dim=0)
total_frames = (context_frames * 2) + vace_count
mask = torch.zeros((total_frames, height, width), dtype=torch.float32, device=video_1.device)
mask[context_frames:context_frames + vace_count] = 1.0
return control_video, mask, vace_count
class WanVACEPrep(WanVACEPrepBase, io.ComfyNode):
@classmethod
def define_schema(cls):
return io.Schema(
node_id="WanVACEPrep",
display_name="🪐 VACE Join",
category="Wan VACE Prep/VACE",
description=(
"Generates VACE control video and mask for smooth transitions between\n"
"two videos using context frames and frame replacement."
),
inputs=[
io.Image.Input("video_1"),
io.Image.Input("video_2"),
io.Int.Input("context_frames", default=8, min=4, max=120, step=4,
tooltip="Reference frames from each video edge for VACE interpolation (multiple of 4)."),
io.Int.Input("replace_frames", default=8, min=0, max=120, step=4,
tooltip="Number of frames to regenerate at each transition edge (multiple of 4)."),
io.Int.Input("new_frames", default=0, min=0, max=240, step=4,
tooltip="Number of new transition frames to generate, in addition to the replace_frames (multiple of 4)."),
],
outputs=[
io.Image.Output("control_video"),
io.Mask.Output("control_mask"),
io.Int.Output("width"),
io.Int.Output("height"),
io.Int.Output("length"),
io.Image.Output("start_images"),
io.Image.Output("end_images"),
io.Int.Output("context_frames"),
io.Int.Output("replace_frames"),
io.Int.Output("new_frames"),
],
)
@classmethod
def execute(cls, video_1, video_2, context_frames, replace_frames, new_frames) -> io.NodeOutput:
width, height = cls._validate_dimensions(video_1, video_2)
v1_len = video_1.shape[0]
v2_len = video_2.shape[0]
required_frames = context_frames + replace_frames
if v1_len < required_frames:
raise ValueError(
f"context_frames ({context_frames}) + replace_frames ({replace_frames}) = {required_frames}, "
f"which is too large for video_1 length of {v1_len}. "
f"Reduce context_frames or replace_frames."
)
if v2_len < required_frames:
raise ValueError(
f"context_frames ({context_frames}) + replace_frames ({replace_frames}) = {required_frames}, "
f"which is too large for video_2 length of {v2_len}. "
f"Reduce context_frames or replace_frames."
)
v1_context, v2_context = cls._extract_context(video_1, video_2, context_frames, replace_frames)
control_video, mask, _ = cls._build_control_video_and_mask(
video_1, v1_context, v2_context, context_frames, replace_frames, new_frames, height, width
)
start_images = video_1[:-(context_frames + replace_frames)]
end_images = video_2[context_frames + replace_frames:]
length = int(control_video.shape[0])
return io.NodeOutput(control_video, mask, width, height, length, start_images, end_images, context_frames, replace_frames, new_frames)
class WanVACEPrepBatch(WanVACEPrepBase, io.ComfyNode):
@classmethod
def define_schema(cls):
return io.Schema(
node_id="WanVACEPrepBatch",
display_name="🪐 VACE Join (Batch)",
category="Wan VACE Prep/VACE",
description="Batch-aware VACE prep that handles first/last iteration edge cases for multi-video processing.",
inputs=[
io.Image.Input("video_1"),
io.Image.Input("video_2"),
io.Boolean.Input("is_first", default=False,
tooltip="True for first iteration (index=0) - includes full beginning of video_1 in start_images."),
io.Boolean.Input("is_last", default=False,
tooltip="True for last iteration - includes full ending of video_2 in end_images."),
io.Int.Input("context_frames", default=8, min=4, max=120, step=4,
tooltip="Reference frames from each video edge for VACE interpolation (multiple of 4)."),
io.Int.Input("replace_frames", default=8, min=0, max=120, step=4,
tooltip="Number of frames to regenerate at each transition edge (multiple of 4)."),
io.Int.Input("new_frames", default=0, min=0, max=240, step=4,
tooltip="Number of new transition frames to generate, in addition to the replace_frames (multiple of 4)."),
io.Boolean.Input("debug", default=False, tooltip="Log details to the console"),
],
outputs=[
io.Image.Output("control_video"),
io.Mask.Output("control_mask"),
io.Int.Output("width"),
io.Int.Output("height"),
io.Int.Output("length"),
io.Image.Output("start_images"),
io.Image.Output("end_images"),
io.Int.Output("context_frames"),
io.Int.Output("replace_frames"),
io.Int.Output("new_frames"),
],
)
@classmethod
def execute(cls, video_1, video_2, is_first, is_last, context_frames, replace_frames, new_frames, debug) -> io.NodeOutput:
width, height = cls._validate_dimensions(video_1, video_2)
if debug:
print(f"\n[VACE Join Batch] === Start ===")
print(f"[VACE Join Batch] Video 1: {video_1.shape[0]} frames @ {width}x{height}")
print(f"[VACE Join Batch] Video 2: {video_2.shape[0]} frames @ {width}x{height}")
print(f"[VACE Join Batch] Flags: {'FIRST ' if is_first else ''}{'LAST' if is_last else 'MIDDLE' if not is_first else ''}")
print(f"[VACE Join Batch] Parameters: context={context_frames}, replace={replace_frames}, new={new_frames}")
v1_len = video_1.shape[0]
v2_len = video_2.shape[0]
required_frames = context_frames + replace_frames
if is_first:
if v1_len < required_frames:
raise ValueError(
f"First iteration: video_1 needs at least {required_frames} frames "
f"(context_frames + replace_frames), but has {v1_len}"
)
else:
if v1_len < required_frames * 2:
raise ValueError(
f"Middle/last iteration: video_1 needs at least {required_frames * 2} frames, "
f"but has {v1_len}"
)
if v2_len < required_frames:
raise ValueError(
f"video_2 needs at least {required_frames} frames "
f"(context_frames + replace_frames), but has {v2_len}"
)
v1_context, v2_context = cls._extract_context(video_1, video_2, context_frames, replace_frames)
control_video, mask, vace_count = cls._build_control_video_and_mask(
video_1, v1_context, v2_context, context_frames, replace_frames, new_frames, height, width
)
if is_first:
start_images = video_1[:-required_frames]
else:
start_images = video_1[required_frames:-required_frames]
if is_last:
end_images = video_2[required_frames:]
else:
channels = video_1.shape[3]
end_images = torch.empty((0, height, width, channels), dtype=video_2.dtype, device=video_2.device)
length = int(control_video.shape[0])
if debug:
print(f"[VACE Join Batch] Outputs:")
print(f"[VACE Join Batch] control_video: {control_video.shape}")
print(f"[VACE Join Batch] control_mask: {mask.shape}")
print(f"[VACE Join Batch] start_images: {start_images.shape[0]} frames")
print(f"[VACE Join Batch] end_images: {end_images.shape[0]} frames")
print(f"[VACE Join Batch] VACE output: {context_frames * 2 + vace_count} frames ({context_frames * 2} context + {vace_count} generated)")
print(f"[VACE Join Batch] === End ===")
return io.NodeOutput(control_video, mask, width, height, length, start_images, end_images, context_frames, replace_frames, new_frames)