Skip to content

Open-Sora: Democratizing Efficient Video Production for All

Python

added gradio (#133)

Frank Lee9dde960b954d
diff --git a/configs/opensora-v1-2/inference/sample.py b/configs/opensora-v1-2/inference/sample.py
index 67f0e01..db913b8 100644
--- a/configs/opensora-v1-2/inference/sample.py
+++ b/configs/opensora-v1-2/inference/sample.py
@@ -25,14 +25,14 @@ align = 5
model = dict(
type="STDiT3-XL/2",
- from_pretrained=None,
+ from_pretrained="/mnt/jfs/sora_checkpoints/042-STDiT3-XL-2/epoch0-global_step7200/ema.pt",
qk_norm=True,
enable_flash_attn=True,
enable_layernorm_kernel=True,
)
vae = dict(
type="OpenSoraVAE_V1_2",
- from_pretrained="pretrained_models/vae-pipeline",
+ from_pretrained="/mnt/jfs/sora_checkpoints/vae-pipeline",
micro_frame_size=17,
micro_batch_size=4,
)
diff --git a/gradio/app.py b/gradio/app.py
index 726b244..d70d682 100644
--- a/gradio/app.py
+++ b/gradio/app.py
@@ -11,10 +11,7 @@ import importlib
import os
import subprocess
import sys
-import re
-import json
import math
-
import spaces
import torch
@@ -24,166 +21,19 @@ import datetime
-MODEL_TYPES = ["v1.1-stage2", "v1.1-stage3"]
+MODEL_TYPES = ["v1.2-stage3"]
CONFIG_MAP = {
- "v1.1-stage2": "configs/opensora-v1-1/inference/sample-ref.py",
- "v1.1-stage3": "configs/opensora-v1-1/inference/sample-ref.py",
+ "v1.2-stage3": "configs/opensora-v1-2/inference/sample.py",
}
HF_STDIT_MAP = {
- "v1.1-stage2": "hpcai-tech/OpenSora-STDiT-v2-stage2",
- "v1.1-stage3": "hpcai-tech/OpenSora-STDiT-v2-stage3",
-}
-RESOLUTION_MAP = {
- "144p": {
- "16:9": (256, 144),
- "9:16": (144, 256),
- "4:3": (221, 165),
- "3:4": (165, 221),
- "1:1": (192, 192),
- },
- "240p": {
- "16:9": (426, 240),
- "9:16": (240, 426),
- "4:3": (370, 278),
- "3:4": (278, 370),
- "1:1": (320, 320),
- },
- "360p": {
- "16:9": (640, 360),
- "9:16": (360, 640),
- "4:3": (554, 416),
- "3:4": (416, 554),
- "1:1": (480, 480),
- },
- "480p": {
- "16:9": (854, 480),
- "9:16": (480, 854),
- "4:3": (740, 555),
- "3:4": (555, 740),
- "1:1": (640, 640),
- },
- "720p": {
- "16:9": (1280, 720),
- "9:16": (720, 1280),
- "4:3": (1108, 832),
- "3:4": (832, 1110),
- "1:1": (960, 960),
- },
+ "v1.2-stage3": {
+ "ema": "/mnt/jfs/sora_checkpoints/042-STDiT3-XL-2/epoch0-global_step7200/ema.pt",
+ "model": "/mnt/jfs/sora_checkpoints/042-STDiT3-XL-2/epoch0-global_step7200/model"
+ }
}
-
-# ============================
-# Utils
-# ============================
-def collect_references_batch(reference_paths, vae, image_size):
- from opensora.datasets.utils import read_from_path
-
- refs_x = []
- for reference_path in reference_paths:
- if reference_path is None:
- refs_x.append([])
- continue
- ref_path = reference_path.split(";")
- ref = []
- for r_path in ref_path:
- r = read_from_path(r_path, image_size, transform_name="resize_crop")
- r_x = vae.encode(r.unsqueeze(0).to(vae.device, vae.dtype))
- r_x = r_x.squeeze(0)
- ref.append(r_x)
- refs_x.append(ref)
- # refs_x: [batch, ref_num, C, T, H, W]
- return refs_x
-
-
-def process_mask_strategy(mask_strategy):
- mask_batch = []
- mask_strategy = mask_strategy.split(";")
- for mask in mask_strategy:
- mask_group = mask.split(",")
- assert len(mask_group) >= 1 and len(mask_group) <= 6, f"Invalid mask strategy: {mask}"
- if len(mask_group) == 1:
- mask_group.extend(["0", "0", "0", "1", "0"])
- elif len(mask_group) == 2:
- mask_group.extend(["0", "0", "1", "0"])
- elif len(mask_group) == 3:
- mask_group.extend(["0", "1", "0"])
- elif len(mask_group) == 4:
- mask_group.extend(["1", "0"])
- elif len(mask_group) == 5:
- mask_group.append("0")
- mask_batch.append(mask_group)
- return mask_batch
-
-
-def apply_mask_strategy(z, refs_x, mask_strategys, loop_i):
- masks = []
- for i, mask_strategy in enumerate(mask_strategys):
- mask = torch.ones(z.shape[2], dtype=torch.float, device=z.device)
- if mask_strategy is None:
- masks.append(mask)
- continue
- mask_strategy = process_mask_strategy(mask_strategy)
- for mst in mask_strategy:
- loop_id, m_id, m_ref_start, m_target_start, m_length, edit_ratio = mst
- loop_id = int(loop_id)
- if loop_id != loop_i:
- continue
- m_id = int(m_id)
- m_ref_start = int(m_ref_start)
- m_length = int(m_length)
- m_target_start = int(m_target_start)
- edit_ratio = float(edit_ratio)
- ref = refs_x[i][m_id] # [C, T, H, W]
- if m_ref_start < 0:
- m_ref_start = ref.shape[1] + m_ref_start
- if m_target_start < 0:
- # z: [B, C, T, H, W]
- m_target_start = z.shape[2] + m_target_start
- z[i, :, m_target_start : m_target_start + m_length] = ref[:, m_ref_start : m_ref_start + m_length]
- mask[m_target_start : m_target_start + m_length] = edit_ratio
- masks.append(mask)
- masks = torch.stack(masks)
- return masks
-
-
-def process_prompts(prompts, num_loop):
- from opensora.models.text_encoder.t5 import text_preprocessing
-
- ret_prompts = []
- for prompt in prompts:
- if prompt.startswith("|0|"):
- prompt_list = prompt.split("|")[1:]
- text_list = []
- for i in range(0, len(prompt_list), 2):
- start_loop = int(prompt_list[i])
- text = prompt_list[i + 1]
- text = text_preprocessing(text)
- end_loop = int(prompt_list[i + 2]) if i + 2 < len(prompt_list) else num_loop
- text_list.extend([text] * (end_loop - start_loop))
- assert len(text_list) == num_loop, f"Prompt loop mismatch: {len(text_list)} != {num_loop}"
- ret_prompts.append(text_list)
- else:
- prompt = text_preprocessing(prompt)
- ret_prompts.append([prompt] * num_loop)
- return ret_prompts
-
-
-def extract_json_from_prompts(prompts):
- additional_infos = []
- ret_prompts = []
- for prompt in prompts:
- parts = re.split(r"(?=[{\[])", prompt)
- assert len(parts) <= 2, f"Invalid prompt: {prompt}"
- ret_prompts.append(parts[0])
- if len(parts) == 1:
- additional_infos.append({})
- else:
- additional_infos.append(json.loads(parts[1]))
- return ret_prompts, additional_infos
-
-
# ============================
-# Runtime Environment
+# Prepare Runtime Environment
# ============================
def install_dependencies(enable_optimization=False):
"""
@@ -255,13 +105,12 @@ def build_models(model_type, config, enable_optimization=False):
# build stdit
# we load model from HuggingFace directly so that we don't need to
# handle model download logic in HuggingFace Space
- from opensora.models.stdit.stdit2 import STDiT2
-
- stdit = STDiT2.from_pretrained(
- HF_STDIT_MAP[model_type],
- enable_flash_attn=enable_optimization,
- trust_remote_code=True,
- ).cuda()
+ from opensora.models.stdit.stdit3 import STDiT3, STDiT3Config
+ stdit3_config = STDiT3Config.from_pretrained(HF_STDIT_MAP[model_type]['model'])
+ stdit = STDiT3(stdit3_config)
+ ckpt = torch.load(HF_STDIT_MAP[model_type]['ema'])
+ stdit.load_state_dict(ckpt)
+ stdit = stdit.cuda()
# build scheduler
from opensora.registry import SCHEDULERS
@@ -285,13 +134,13 @@ def parse_args():
parser = argparse.ArgumentParser()
parser.add_argument(
"--model-type",
- default="v1.1-stage3",
+ default="v1.2-stage3",
choices=MODEL_TYPES,
help=f"The type of model to run for the Gradio App, can only be {MODEL_TYPES}",
)
parser.add_argument("--output", default="./outputs", type=str, help="The path to the output folder")
parser.add_argument("--port", default=None, type=int, help="The port to run the Gradio App on.")
- parser.add_argument("--host", default=None, type=str, help="The host to run the Gradio App on.")
+ parser.add_argument("--host", default="0.0.0.0", type=str, help="The host to run the Gradio App on.")
parser.add_argument("--share", action="store_true", help="Whether to share this gradio demo.")
parser.add_argument(
"--enable-optimization",
@@ -311,6 +160,8 @@ def parse_args():
# read config
args = parse_args()
config = read_config(CONFIG_MAP[args.model_type])
+torch.backends.cuda.matmul.allow_tf32 = True
+torch.backends.cudnn.allow_tf32 = True
# make outputs dir
os.makedirs(args.output, exist_ok=True)
@@ -325,6 +176,18 @@ install_dependencies(enable_optimization=args.enable_optimization)
# import after installation
from opensora.datasets import IMG_FPS, save_sample
from opensora.utils.misc import to_torch_dtype
+from opensora.utils.inference_utils import (
+ append_generated,
+ apply_mask_strategy,
+ collect_references_batch,
+ extract_json_from_prompts,
+ extract_prompts_loop,
+ prepare_multi_resolution_info,
+ dframe_to_frame,
+ append_score_to_prompts
+)
+from opensora.models.text_encoder.t5 import text_preprocessing
+from opensora.datasets.aspect import get_image_size, get_num_frames
# some global variables
dtype = to_torch_dtype(config.dtype)
@@ -334,62 +197,42 @@ device = torch.device("cuda")
vae, text_encoder, stdit, scheduler = build_models(args.model_type, config, enable_optimization=args.enable_optimization)
-def run_inference(mode, prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale):
+def run_inference(mode, prompt_text, resolution, aspect_ratio, length, motion_strength, aesthetic_score, use_motion_strength, use_aesthetic_score, use_timestep_transform, reference_image, seed, sampling_steps, cfg_scale):
torch.manual_seed(seed)
with torch.inference_mode():
# ======================
- # 1. Preparation
+ # 1. Preparation arguments
# ======================
# parse the inputs
- resolution = RESOLUTION_MAP[resolution][aspect_ratio]
-
- # gather args from config
- num_frames = config.num_frames
- frame_interval = config.frame_interval
- fps = config.fps
+ # frame_interval must be 1 so we ignore it here
+ image_size = get_image_size(resolution, aspect_ratio)
condition_frame_length = config.condition_frame_length
-
- # compute number of loops
+
+ # compute generation parameters
if mode == "Text2Image":
num_frames = 1
num_loop = 1
+ fps = IMG_FPS
else:
- num_seconds = int(length.rstrip('s'))
- if num_seconds <= 16:
- num_frames = num_seconds * fps // frame_interval
+ fps = config.fps
+ num_frames = config.num_frames
+ seconds = int(length.rstrip('s'))
+
+ if seconds <= 16:
+ num_frames = get_num_frames(length)
num_loop = 1
else:
- config.num_frames = 16
- total_number_of_frames = num_seconds * fps / frame_interval
- num_loop = math.ceil((total_number_of_frames - condition_frame_length) / (num_frames - condition_frame_length))
-
- # prepare model args
- if config.num_frames == 1:
- fps = IMG_FPS
-
- model_args = dict()
- height_tensor = torch.tensor([resolution[0]], device=device, dtype=dtype)
- width_tensor = torch.tensor([resolution[1]], device=device, dtype=dtype)
- num_frames_tensor = torch.tensor([num_frames], device=device, dtype=dtype)
- ar_tensor = torch.tensor([resolution[0] / resolution[1]], device=device, dtype=dtype)
- fps_tensor = torch.tensor([fps], device=device, dtype=dtype)
- model_args["height"] = height_tensor
- model_args["width"] = width_tensor
- model_args["num_frames"] = num_frames_tensor
- model_args["ar"] = ar_tensor
- model_args["fps"] = fps_tensor
-
- # compute latent size
- input_size = (num_frames, *resolution)
+ total_num_frames = fps * seconds
+ condition_real_frame_length = dframe_to_frame(condition_frame_length)
+ num_subsequence_loop = int((total_num_frames - num_frames) / (num_frames - condition_real_frame_length))
+ num_loop = num_subsequence_loop + 1
+
+ input_size = (num_frames, *image_size)
latent_size = vae.get_latent_size(input_size)
-
- # process prompt
- prompt_raw = [prompt_text]
- prompt_raw, _ = extract_json_from_prompts(prompt_raw)
- prompt_loops = process_prompts(prompt_raw, num_loop)
- video_clips = []
-
- # prepare mask strategy
+ multi_resolution = "OpenSora"
+ align = 5
+
+ # prepare reference
if mode == "Text2Image":
mask_strategy = [None]
elif mode == "Text2Video":
@@ -399,59 +242,67 @@ def run_inference(mode, prompt_text, resolution, aspect_ratio, length, reference
mask_strategy = [None]
else:
raise ValueError(f"Invalid mode: {mode}")
-
- # =========================
- # 2. Load reference images
- # =========================
+
+ # prepare refs
if mode == "Text2Image":
- refs_x = collect_references_batch([None], vae, resolution)
+ refs = [""]
elif mode == "Text2Video":
if reference_image is not None:
# save image to disk
from PIL import Image
im = Image.fromarray(reference_image)
-
- with NamedTemporaryFile(suffix=".jpg") as temp_file:
- im.save(temp_file.name)
- refs_x = collect_references_batch([temp_file.name], vae, resolution)
+ temp_file = NamedTemporaryFile(suffix=".png")
+ im.save(temp_file.name)
+ refs = [temp_file.name]
else:
- refs_x = collect_references_batch([None], vae, resolution)
+ refs = [""]
else:
raise ValueError(f"Invalid mode: {mode}")
+
+ # process prompt
+ batch_prompts = [prompt_text]
+ batch_prompts, refs, mask_strategy = extract_json_from_prompts(batch_prompts, refs, mask_strategy)
+
+ refs = collect_references_batch(refs, vae, image_size)
+
+ # process scores
+ use_motion_strength = use_motion_strength and mode != "Text2Image"
+ batch_prompts = append_score_to_prompts(
+ batch_prompts,
+ aes=aesthetic_score if use_aesthetic_score else None,
+ flow=motion_strength if use_motion_strength else None
+ )
+
+ # multi-resolution info
+ model_args = prepare_multi_resolution_info(
+ multi_resolution, len(batch_prompts), image_size, num_frames, fps, device, dtype
+ )
- # 4.3. long video generation
+ # =========================
+ # Generate image/video
+ # =========================
+ video_clips = []
+
for loop_i in range(num_loop):
# 4.4 sample in hidden space
- batch_prompts = [prompt[loop_i] for prompt in prompt_loops]
- z = torch.randn(len(batch_prompts), vae.out_channels, *latent_size, device=device, dtype=dtype)
-
- # 4.5. apply mask strategy
- masks = None
-
- # if cfg.reference_path is not None:
+ batch_prompts_loop = extract_prompts_loop(batch_prompts, loop_i)
+ batch_prompts_cleaned = [text_preprocessing(prompt) for prompt in batch_prompts_loop]
+
+ # == loop ==
if loop_i > 0:
- ref_x = vae.encode(video_clips[-1])
- for j, refs in enumerate(refs_x):
- if refs is None:
- refs_x[j] = [ref_x[j]]
- else:
- refs.append(ref_x[j])
- if mask_strategy[j] is None:
- mask_strategy[j] = ""
- else:
- mask_strategy[j] += ";"
- mask_strategy[
- j
- ] += f"{loop_i},{len(refs)-1},-{condition_frame_length},0,{condition_frame_length}"
-
- masks = apply_mask_strategy(z, refs_x, mask_strategy, loop_i)
-
+ refs, mask_strategy = append_generated(vae, video_clips[-1], refs, mask_strategy, loop_i, condition_frame_length)
+
+ # == sampling ==
+ z = torch.randn(len(batch_prompts), vae.out_channels, *latent_size, device=device, dtype=dtype)
+ masks = apply_mask_strategy(z, refs, mask_strategy, loop_i, align=align)
+
# 4.6. diffusion sampling
# hack to update num_sampling_steps and cfg_scale
scheduler_kwargs = config.scheduler.copy()
scheduler_kwargs.pop('type')
scheduler_kwargs['num_sampling_steps'] = sampling_steps
scheduler_kwargs['cfg_scale'] = cfg_scale
+ scheduler_kwargs['use_timestep_transform'] = use_timestep_transform
scheduler.__init__(
**scheduler_kwargs
@@ -460,34 +311,95 @@ def run_inference(mode, prompt_text, resolution, aspect_ratio, length, reference
stdit,
text_encoder,
z=z,
- prompts=batch_prompts,
+ prompts=batch_prompts_cleaned,
device=device,
additional_args=model_args,
- mask=masks, # scheduler must support mask
+ progress=True,
+ mask=masks,
)
- samples = vae.decode(samples.to(dtype))
+ samples = vae.decode(samples.to(dtype), num_frames=num_frames)
video_clips.append(samples)
-
- # 4.7. save video
- if loop_i == num_loop - 1:
- video_clips_list = [
- video_clips[0][0]] + [video_clips[i][0][:, config.condition_frame_length :]
- for i in range(1, num_loop)
- ]
- video = torch.cat(video_clips_list, dim=1)
- current_datetime = datetime.datetime.now()
- timestamp = current_datetime.timestamp()
- save_path = os.path.join(args.output, f"output_{timestamp}")
- saved_path = save_sample(video, save_path=save_path, fps=config.fps // config.frame_interval)
- return saved_path
+
+ # =========================
+ # Save output
+ # =========================
+ video_clips = [val[0] for val in video_clips]
+ for i in range(1, num_loop):
+ video_clips[i] = video_clips[i][:, dframe_to_frame(condition_frame_length) :]
+ video = torch.cat(video_clips, dim=1)
+ current_datetime = datetime.datetime.now()
+ timestamp = current_datetime.timestamp()
+ save_path = os.path.join(args.output, f"output_{timestamp}")
+ saved_path = save_sample(video, save_path=save_path, fps=fps)
+ torch.cuda.empty_cache()
+ return saved_path
@spaces.GPU(duration=200)
-def run_image_inference(prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale):
- return run_inference("Text2Image", prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale)
+def run_image_inference(
+ prompt_text,
+ resolution,
+ aspect_ratio,
+ length,
+ motion_strength,
+ aesthetic_score,
+ use_motion_strength,
+ use_aesthetic_score,
+ use_timestep_transform,
+ reference_image,
+ seed,
+ sampling_steps,
+ cfg_scale):
+ return run_inference(
+ "Text2Image",
+ prompt_text,
+ resolution,
+ aspect_ratio,
+ length,
+ motion_strength,
+ aesthetic_score,
+ use_motion_strength,
+ use_aesthetic_score,
+ use_timestep_transform,
+ reference_image,
+ seed,
+ sampling_steps,
+ cfg_scale)
@spaces.GPU(duration=200)
-def run_video_inference(prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale):
- return run_inference("Text2Video", prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale)
+def run_video_inference(
+ prompt_text,
+ resolution,
+ aspect_ratio,
+ length,
+ motion_strength,
+ aesthetic_score,
+ use_motion_strength,
+ use_aesthetic_score,
+ use_timestep_transform,
+ reference_image,
+ seed,
+ sampling_steps,
+ cfg_scale):
+ if (resolution == "480p" and length == "16s") or \
+ (resolution == "720p" and length in ["8s", "16s"]):
+ gr.Warning("Generation is interrupted as the combination of 480p and 16s will lead to CUDA out of memory")
+ else:
+ return run_inference(
+ "Text2Video",
+ prompt_text,
+ resolution,
+ aspect_ratio,
+ length,
+ motion_strength,
+ aesthetic_score,
+ use_motion_strength,
+ use_aesthetic_score,
+ use_timestep_transform,
+ reference_image,
+ seed,
+ sampling_steps,
+ cfg_scale
+ )
def main():
@@ -524,7 +436,7 @@ def main():
)
resolution = gr.Radio(
choices=["144p", "240p", "360p", "480p", "720p"],
- value="240p",
+ value="480p",
label="Resolution",
)
aspect_ratio = gr.Radio(
@@ -535,8 +447,8 @@ def main():
length = gr.Radio(
choices=["2s", "4s", "8s", "16s"],
value="2s",
- label="Video Length (only effective for video generation)",
- info="8s may fail as Hugging Face ZeroGPU has the limitation of max 200 seconds inference time."
+ label="Video Length",
+ info="only effective for video generation, 8s may fail as Hugging Face ZeroGPU has the limitation of max 200 seconds inference time."
)
with gr.Row():
@@ -549,7 +461,7 @@ def main():
)
sampling_steps = gr.Slider(
- value=100,
+ value=30,
minimum=1,
maximum=200,
step=1,
@@ -562,9 +474,36 @@ def main():
step=0.1,
label="CFG Scale"
)
+
+ with gr.Row():
+ with gr.Column():
+ motion_strength = gr.Slider(
+ value=100,
+ minimum=0,
+ maximum=500,
+ step=1,
+ label="Motion Strength",
+ info="only effective for video generation"
+ )
+ use_motion_strength = gr.Checkbox(value=False, label="Enable")
+
+ with gr.Column():
+ aesthetic_score = gr.Slider(
+ value=6,
+ minimum=4,
+ maximum=7,
+ step=1,
+ label="Aesthetic",
+ info="effective for text & video generation"
+ )
+ use_aesthetic_score = gr.Checkbox(value=True, label="Enable")
+
+ use_timestep_transform = gr.Checkbox(value=True, label="Use Time Transform")
+
reference_image = gr.Image(
label="Reference Image (Optional)",
+ show_download_button=True
)
with gr.Column():
@@ -580,12 +519,12 @@ def main():
image_gen_button.click(
fn=run_image_inference,
- inputs=[prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale],
+ inputs=[prompt_text, resolution, aspect_ratio, length, motion_strength, aesthetic_score, use_motion_strength, use_aesthetic_score, use_timestep_transform, reference_image, seed, sampling_steps, cfg_scale],
outputs=reference_image
)
video_gen_button.click(
fn=run_video_inference,
- inputs=[prompt_text, resolution, aspect_ratio, length, reference_image, seed, sampling_steps, cfg_scale],
+ inputs=[prompt_text, resolution, aspect_ratio, length, motion_strength, aesthetic_score, use_motion_strength, use_aesthetic_score, use_timestep_transform, reference_image, seed, sampling_steps, cfg_scale],
outputs=output_video
)
diff --git a/opensora/utils/inference_utils.py b/opensora/utils/inference_utils.py
index d13c5ea..9bd5f11 100644
--- a/opensora/utils/inference_utils.py
+++ b/opensora/utils/inference_utils.py
@@ -73,7 +73,7 @@ def append_score_to_prompts(prompts, aes=None, flow=None):
def extract_json_from_prompts(prompts, reference, mask_strategy):
ret_prompts = []
for i, prompt in enumerate(prompts):
- parts = re.split(r"(?=[{\[])", prompt)
+ parts = re.split(r"(?=[{])", prompt)
assert len(parts) <= 2, f"Invalid prompt: {prompt}"
ret_prompts.append(parts[0])
if len(parts) > 1: