CogVideoX

CogVideoX: Text-to-Video Diffusion Models with An Expert Transformer from Tsinghua University & ZhipuAI, by Zhuoyi Yang, Jiayan Teng, Wendi Zheng, Ming Ding, Shiyu Huang, Jiazheng Xu, Yuanming Yang, Wenyi Hong, Xiaohan Zhang, Guanyu Feng, Da Yin, Xiaotao Gu, Yuxuan Zhang, Weihan Wang, Yean Cheng, Ting Liu, Bin Xu, Yuxiao Dong, Jie Tang.

The abstract from the paper is:

We introduce CogVideoX, a large-scale diffusion transformer model designed for generating videos based on text prompts. To efficently model video data, we propose to levearge a 3D Variational Autoencoder (VAE) to compresses videos along both spatial and temporal dimensions. To improve the text-video alignment, we propose an expert transformer with the expert adaptive LayerNorm to facilitate the deep fusion between the two modalities. By employing a progressive training technique, CogVideoX is adept at producing coherent, long-duration videos characterized by significant motion. In addition, we develop an effectively text-video data processing pipeline that includes various data preprocessing strategies and a video captioning method. It significantly helps enhance the performance of CogVideoX, improving both generation quality and semantic alignment. Results show that CogVideoX demonstrates state-of-the-art performance across both multiple machine metrics and human evaluations. The model weight of CogVideoX-2B is publicly available at https://github.com/THUDM/CogVideo.

Make sure to check out the Schedulers guide to learn how to explore the tradeoff between scheduler speed and quality, and see the reuse components across pipelines section to learn how to efficiently load the same components into multiple pipelines.

This pipeline was contributed by zRzRzRzRzRzRzR. The original codebase can be found here. The original weights can be found under hf.co/THUDM.

There are three official CogVideoX checkpoints for text-to-video and video-to-video.

checkpoints	recommended inference dtype
`THUDM/CogVideoX-2b`	torch.float16
`THUDM/CogVideoX-5b`	torch.bfloat16
`THUDM/CogVideoX1.5-5b`	torch.bfloat16

There are two official CogVideoX checkpoints available for image-to-video.

checkpoints	recommended inference dtype
`THUDM/CogVideoX-5b-I2V`	torch.bfloat16
`THUDM/CogVideoX-1.5-5b-I2V`	torch.bfloat16

For the CogVideoX 1.5 series:

Text-to-video (T2V) works best at a resolution of 1360x768 because it was trained with that specific resolution.
Image-to-video (I2V) works for multiple resolutions. The width can vary from 768 to 1360, but the height must be 768. The height/width must be divisible by 16.
Both T2V and I2V models support generation with 81 and 161 frames and work best at this value. Exporting videos at 16 FPS is recommended.

There are two official CogVideoX checkpoints that support pose controllable generation (by the Alibaba-PAI team).

checkpoints	recommended inference dtype
`alibaba-pai/CogVideoX-Fun-V1.1-2b-Pose`	torch.bfloat16
`alibaba-pai/CogVideoX-Fun-V1.1-5b-Pose`	torch.bfloat16

Inference

Use torch.compile to reduce the inference latency.

First, load the pipeline:

import torch
from diffusers import CogVideoXPipeline, CogVideoXImageToVideoPipeline
from diffusers.utils import export_to_video,load_image
pipe = CogVideoXPipeline.from_pretrained("THUDM/CogVideoX-5b").to("cuda") # or "THUDM/CogVideoX-2b"

If you are using the image-to-video pipeline, load it as follows:

pipe = CogVideoXImageToVideoPipeline.from_pretrained("THUDM/CogVideoX-5b-I2V").to("cuda")

Then change the memory layout of the pipelines transformer component to torch.channels_last:

pipe.transformer.to(memory_format=torch.channels_last)

Compile the components and run inference:

pipe.transformer = torch.compile(pipeline.transformer, mode="max-autotune", fullgraph=True)

# CogVideoX works well with long and well-described prompts
prompt = "A panda, dressed in a small, red jacket and a tiny hat, sits on a wooden stool in a serene bamboo forest. The panda's fluffy paws strum a miniature acoustic guitar, producing soft, melodic tunes. Nearby, a few other pandas gather, watching curiously and some clapping in rhythm. Sunlight filters through the tall bamboo, casting a gentle glow on the scene. The panda's face is expressive, showing concentration and joy as it plays. The background includes a small, flowing stream and vibrant green foliage, enhancing the peaceful and magical atmosphere of this unique musical performance."
video = pipe(prompt=prompt, guidance_scale=6, num_inference_steps=50).frames[0]

The T2V benchmark results on an 80GB A100 machine are:

Without torch.compile(): Average inference time: 96.89 seconds.
With torch.compile(): Average inference time: 76.27 seconds.

Memory optimization

CogVideoX-2b requires about 19 GB of GPU memory to decode 49 frames (6 seconds of video at 8 FPS) with output resolution 720x480 (W x H), which makes it not possible to run on consumer GPUs or free-tier T4 Colab. The following memory optimizations could be used to reduce the memory footprint. For replication, you can refer to this script.

pipe.enable_model_cpu_offload():
- Without enabling cpu offloading, memory usage is 33 GB
- With enabling cpu offloading, memory usage is 19 GB
pipe.enable_sequential_cpu_offload():
- Similar to enable_model_cpu_offload but can significantly reduce memory usage at the cost of slow inference
- When enabled, memory usage is under 4 GB
pipe.vae.enable_tiling():
- With enabling cpu offloading and tiling, memory usage is 11 GB
pipe.vae.enable_slicing()

Quantized inference

torchao and optimum-quanto can be used to quantize the text encoder, transformer and VAE modules to lower the memory requirements. This makes it possible to run the model on a free-tier T4 Colab or lower VRAM GPUs!

It is also worth noting that torchao quantization is fully compatible with torch.compile, which allows for much faster inference speed. Additionally, models can be serialized and stored in a quantized datatype to save disk space with torchao. Find examples and benchmarks in the gists below.

CogVideoXPipeline

[[autodoc]] CogVideoXPipeline

all
call

CogVideoXImageToVideoPipeline

[[autodoc]] CogVideoXImageToVideoPipeline

all
call

CogVideoXVideoToVideoPipeline

[[autodoc]] CogVideoXVideoToVideoPipeline

all
call

CogVideoXFunControlPipeline

[[autodoc]] CogVideoXFunControlPipeline

all
call

CogVideoXPipelineOutput

[[autodoc]] pipelines.cogvideo.pipeline_output.CogVideoXPipelineOutput