github-actions[bot]
284 lines
10 KiB
Python
284 lines
10 KiB
Python
import logging
|
|
from collections.abc import Iterator
|
|
|
|
import torch
|
|
|
|
from ltx_core.components.guiders import (
|
|
MultiModalGuiderFactory,
|
|
MultiModalGuiderParams,
|
|
create_multimodal_guider_factory,
|
|
)
|
|
from ltx_core.components.noisers import GaussianNoiser
|
|
from ltx_core.components.schedulers import LTX2Scheduler
|
|
from ltx_core.loader import LoraPathStrengthAndSDOps
|
|
from ltx_core.loader.registry import Registry
|
|
from ltx_core.model.video_vae import TilingConfig, get_video_chunks_number
|
|
from ltx_core.quantization import QuantizationPolicy
|
|
from ltx_core.types import Audio, VideoPixelShape
|
|
from ltx_pipelines.utils.args import ImageConditioningInput, default_2_stage_arg_parser, detect_checkpoint_path
|
|
from ltx_pipelines.utils.blocks import (
|
|
AudioDecoder,
|
|
DiffusionStage,
|
|
ImageConditioner,
|
|
PromptEncoder,
|
|
VideoDecoder,
|
|
VideoUpsampler,
|
|
)
|
|
from ltx_pipelines.utils.constants import (
|
|
STAGE_2_DISTILLED_SIGMA_VALUES,
|
|
detect_params,
|
|
)
|
|
from ltx_pipelines.utils.denoisers import FactoryGuidedDenoiser, SimpleDenoiser
|
|
from ltx_pipelines.utils.helpers import (
|
|
assert_resolution,
|
|
get_device,
|
|
image_conditionings_by_adding_guiding_latent,
|
|
)
|
|
from ltx_pipelines.utils.media_io import encode_video
|
|
from ltx_pipelines.utils.types import ModalitySpec
|
|
|
|
|
|
class KeyframeInterpolationPipeline:
|
|
"""
|
|
Keyframe-based Two-stage video interpolation pipeline.
|
|
Interpolates between keyframes to generate a video with smoother transitions.
|
|
Stage 1 generates video at half of the target resolution, then Stage 2 upsamples
|
|
by 2x and refines with additional denoising steps for higher quality output.
|
|
Stage 1 uses full model while Stage 2 uses distilled LORA for efficiency,
|
|
as the upsampled video already has good quality and just needs refinement.
|
|
"""
|
|
|
|
def __init__(
|
|
self,
|
|
checkpoint_path: str,
|
|
distilled_lora: list[LoraPathStrengthAndSDOps],
|
|
spatial_upsampler_path: str,
|
|
gemma_root: str,
|
|
loras: list[LoraPathStrengthAndSDOps],
|
|
device: torch.device | None = None,
|
|
quantization: QuantizationPolicy | None = None,
|
|
registry: Registry | None = None,
|
|
torch_compile: bool = False,
|
|
):
|
|
self.device = device or get_device()
|
|
self.dtype = torch.bfloat16
|
|
|
|
self.prompt_encoder = PromptEncoder(checkpoint_path, gemma_root, self.dtype, self.device, registry=registry)
|
|
self.image_conditioner = ImageConditioner(checkpoint_path, self.dtype, self.device, registry=registry)
|
|
self.stage_1 = DiffusionStage(
|
|
checkpoint_path,
|
|
self.dtype,
|
|
self.device,
|
|
loras=tuple(loras),
|
|
quantization=quantization,
|
|
registry=registry,
|
|
torch_compile=torch_compile,
|
|
)
|
|
stage_2_loras = (*tuple(loras), *tuple(distilled_lora))
|
|
self.stage_2 = DiffusionStage(
|
|
checkpoint_path,
|
|
self.dtype,
|
|
self.device,
|
|
loras=stage_2_loras,
|
|
quantization=quantization,
|
|
registry=registry,
|
|
torch_compile=torch_compile,
|
|
)
|
|
self.upsampler = VideoUpsampler(
|
|
checkpoint_path, spatial_upsampler_path, self.dtype, self.device, registry=registry
|
|
)
|
|
self.video_decoder = VideoDecoder(checkpoint_path, self.dtype, self.device, registry=registry)
|
|
self.audio_decoder = AudioDecoder(checkpoint_path, self.dtype, self.device, registry=registry)
|
|
|
|
def __call__( # noqa: PLR0913
|
|
self,
|
|
prompt: str,
|
|
negative_prompt: str,
|
|
seed: int,
|
|
height: int,
|
|
width: int,
|
|
num_frames: int,
|
|
frame_rate: float,
|
|
num_inference_steps: int,
|
|
video_guider_params: MultiModalGuiderParams | MultiModalGuiderFactory,
|
|
audio_guider_params: MultiModalGuiderParams | MultiModalGuiderFactory,
|
|
images: list[ImageConditioningInput],
|
|
tiling_config: TilingConfig | None = None,
|
|
enhance_prompt: bool = False,
|
|
streaming_prefetch_count: int | None = None,
|
|
max_batch_size: int = 1,
|
|
) -> tuple[Iterator[torch.Tensor], Audio]:
|
|
assert_resolution(height=height, width=width, is_two_stage=True)
|
|
|
|
generator = torch.Generator(device=self.device).manual_seed(seed)
|
|
noiser = GaussianNoiser(generator=generator)
|
|
dtype = torch.bfloat16
|
|
|
|
ctx_p, ctx_n = self.prompt_encoder(
|
|
[prompt, negative_prompt],
|
|
enhance_first_prompt=enhance_prompt,
|
|
enhance_prompt_image=images[0][0] if len(images) > 0 else None,
|
|
enhance_prompt_seed=seed,
|
|
streaming_prefetch_count=streaming_prefetch_count,
|
|
)
|
|
v_context_p, a_context_p = ctx_p.video_encoding, ctx_p.audio_encoding
|
|
v_context_n, a_context_n = ctx_n.video_encoding, ctx_n.audio_encoding
|
|
|
|
# Stage 1: Initial low resolution video generation.
|
|
sigmas = LTX2Scheduler().execute(steps=num_inference_steps).to(dtype=torch.float32, device=self.device)
|
|
|
|
stage_1_output_shape = VideoPixelShape(
|
|
batch=1,
|
|
frames=num_frames,
|
|
width=width // 2,
|
|
height=height // 2,
|
|
fps=frame_rate,
|
|
)
|
|
stage_1_conditionings = self.image_conditioner(
|
|
lambda enc: image_conditionings_by_adding_guiding_latent(
|
|
images=images,
|
|
height=stage_1_output_shape.height,
|
|
width=stage_1_output_shape.width,
|
|
video_encoder=enc,
|
|
dtype=dtype,
|
|
device=self.device,
|
|
)
|
|
)
|
|
|
|
video_guider_factory = create_multimodal_guider_factory(
|
|
params=video_guider_params,
|
|
negative_context=v_context_n,
|
|
)
|
|
audio_guider_factory = create_multimodal_guider_factory(
|
|
params=audio_guider_params,
|
|
negative_context=a_context_n,
|
|
)
|
|
|
|
video_state, audio_state = self.stage_1(
|
|
denoiser=FactoryGuidedDenoiser(
|
|
v_context=v_context_p,
|
|
a_context=a_context_p,
|
|
video_guider_factory=video_guider_factory,
|
|
audio_guider_factory=audio_guider_factory,
|
|
),
|
|
sigmas=sigmas,
|
|
noiser=noiser,
|
|
width=stage_1_output_shape.width,
|
|
height=stage_1_output_shape.height,
|
|
frames=num_frames,
|
|
fps=frame_rate,
|
|
video=ModalitySpec(
|
|
context=v_context_p,
|
|
conditionings=stage_1_conditionings,
|
|
),
|
|
audio=ModalitySpec(
|
|
context=a_context_p,
|
|
),
|
|
streaming_prefetch_count=streaming_prefetch_count,
|
|
max_batch_size=max_batch_size,
|
|
)
|
|
|
|
# Stage 2: Upsample and refine the video at higher resolution with distilled LORA.
|
|
upscaled_video_latent = self.upsampler(video_state.latent[:1])
|
|
|
|
distilled_sigmas = torch.Tensor(STAGE_2_DISTILLED_SIGMA_VALUES).to(self.device)
|
|
stage_2_output_shape = VideoPixelShape(batch=1, frames=num_frames, width=width, height=height, fps=frame_rate)
|
|
stage_2_conditionings = self.image_conditioner(
|
|
lambda enc: image_conditionings_by_adding_guiding_latent(
|
|
images=images,
|
|
height=stage_2_output_shape.height,
|
|
width=stage_2_output_shape.width,
|
|
video_encoder=enc,
|
|
dtype=dtype,
|
|
device=self.device,
|
|
)
|
|
)
|
|
|
|
video_state, audio_state = self.stage_2(
|
|
denoiser=SimpleDenoiser(v_context_p, a_context_p),
|
|
sigmas=distilled_sigmas,
|
|
noiser=noiser,
|
|
width=width,
|
|
height=height,
|
|
frames=num_frames,
|
|
fps=frame_rate,
|
|
video=ModalitySpec(
|
|
context=v_context_p,
|
|
conditionings=stage_2_conditionings,
|
|
noise_scale=distilled_sigmas[0].item(),
|
|
initial_latent=upscaled_video_latent,
|
|
),
|
|
audio=ModalitySpec(
|
|
context=a_context_p,
|
|
noise_scale=distilled_sigmas[0].item(),
|
|
initial_latent=audio_state.latent,
|
|
),
|
|
streaming_prefetch_count=streaming_prefetch_count,
|
|
)
|
|
|
|
decoded_video = self.video_decoder(video_state.latent, tiling_config, generator)
|
|
decoded_audio = self.audio_decoder(audio_state.latent)
|
|
return decoded_video, decoded_audio
|
|
|
|
|
|
@torch.inference_mode()
|
|
def main() -> None:
|
|
logging.getLogger().setLevel(logging.INFO)
|
|
checkpoint_path = detect_checkpoint_path()
|
|
params = detect_params(checkpoint_path)
|
|
parser = default_2_stage_arg_parser(params=params)
|
|
args = parser.parse_args()
|
|
pipeline = KeyframeInterpolationPipeline(
|
|
checkpoint_path=args.checkpoint_path,
|
|
distilled_lora=args.distilled_lora,
|
|
spatial_upsampler_path=args.spatial_upsampler_path,
|
|
gemma_root=args.gemma_root,
|
|
loras=tuple(args.lora) if args.lora else (),
|
|
quantization=args.quantization,
|
|
torch_compile=args.compile,
|
|
)
|
|
tiling_config = TilingConfig.default()
|
|
video_chunks_number = get_video_chunks_number(args.num_frames, tiling_config)
|
|
video, audio = pipeline(
|
|
prompt=args.prompt,
|
|
negative_prompt=args.negative_prompt,
|
|
seed=args.seed,
|
|
height=args.height,
|
|
width=args.width,
|
|
num_frames=args.num_frames,
|
|
frame_rate=args.frame_rate,
|
|
num_inference_steps=args.num_inference_steps,
|
|
video_guider_params=MultiModalGuiderParams(
|
|
cfg_scale=args.video_cfg_guidance_scale,
|
|
stg_scale=args.video_stg_guidance_scale,
|
|
rescale_scale=args.video_rescale_scale,
|
|
modality_scale=args.a2v_guidance_scale,
|
|
skip_step=args.video_skip_step,
|
|
stg_blocks=args.video_stg_blocks,
|
|
),
|
|
audio_guider_params=MultiModalGuiderParams(
|
|
cfg_scale=args.audio_cfg_guidance_scale,
|
|
stg_scale=args.audio_stg_guidance_scale,
|
|
rescale_scale=args.audio_rescale_scale,
|
|
modality_scale=args.v2a_guidance_scale,
|
|
skip_step=args.audio_skip_step,
|
|
stg_blocks=args.audio_stg_blocks,
|
|
),
|
|
images=args.images,
|
|
tiling_config=tiling_config,
|
|
streaming_prefetch_count=args.streaming_prefetch_count,
|
|
max_batch_size=args.max_batch_size,
|
|
)
|
|
|
|
encode_video(
|
|
video=video,
|
|
fps=args.frame_rate,
|
|
audio=audio,
|
|
output_path=args.output_path,
|
|
video_chunks_number=video_chunks_number,
|
|
)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|