Home

Awesome

This is the code release for the ICLR2024 paper Consistent Video-to-Video Transfer Using Synthetic Dataset.

teaser

Quick Links

Updates

Installation

git clone https://github.com/amazon-science/instruct-video-to-video.git
pip install -r requirements.txt

NOTE: The code is tested on PyTorch 2.1.0+cu11.8 and corresponding xformers version. Any PyTorch version > 2.0 should work but please install the right corresponding xformers version.

Video Editing

We are undergoing the model release process. Please stay tuned.

Download the InsV2V model weights and change the ckpt path in the following notebook.

✨🚀 This notebook provide a sample code to conduct text-based video editing.

Download LOVEU Dataset for Testing

Please follow the instructions in the LOVEU Dataset to download the dataset. Use the following script to run editing on the LOVEU dataset:

python insv2v_run_loveu_tgve.py \
    --config configs/instruct_v2v.yaml \
    --ckpt-path [PATH TO THE CHECKPOINT] \
    --data-dir [PATH TO THE LOVEU DATASET] \
    --with_optical_flow \ # use motion compensation
    --text-cfg 7.5 10 \
    --video-cfg 1.2 1.5 \
    --image-size 256 384

Note: you may need to try different combination of image resolution, video/text classifier free guidance scale to find the best editing results.

Example results of editing LOVEU-TGVE Dataset:

<table> <tr> <td><img src="./figures/videos/audi-snow-trail_background.gif" alt="Image Description"/></td> <td><img src="./figures/videos/cat-in-the-sun_background.gif" alt="Image Description"/></td> </tr> <tr> <td><img src="./figures/videos/swans_object.gif" alt="Image Description" /></td> <td><img src="./figures/videos/drift-turn_style.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/videos/earth-full-view_background.gif" alt="Image Description" /></td> <td><img src="./figures/videos/ferris-wheel-timelapse_background.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/videos/ice-hockey_object.gif" alt="Image Description" /></td> <td><img src="./figures/videos/miami-surf_background.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/videos/raindrops_style.gif" alt="Image Description" /></td> <td><img src="./figures/videos/red-roses-sunny-day_style.gif" alt="Image Description" /></td> </tr> </table>

Synthetic Video Prompt-to-Prompt Dataset

Generation pipeline of the synthetic video dataset: generation pipeline

Examples of the synthetic video dataset:

<table> <tr> <td><img src="./figures/synthetic_sample/synthetic_video_1_0.gif" alt="Image Description"/></td> <td><img src="./figures/synthetic_sample/synthetic_video_18_0.gif" alt="Image Description"/></td> </tr> <tr> <td><img src="./figures/synthetic_sample/synthetic_video_24_0.gif" alt="Image Description" /></td> <td><img src="./figures/synthetic_sample/synthetic_video_81_0.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/synthetic_sample/synthetic_video_92_0.gif" alt="Image Description" /></td> <td><img src="./figures/synthetic_sample/synthetic_video_106_0.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/synthetic_sample/synthetic_video_116_0.gif" alt="Image Description" /></td> <td><img src="./figures/synthetic_sample/synthetic_video_141_0.gif" alt="Image Description" /></td> </tr> <tr> <td><img src="./figures/synthetic_sample/synthetic_video_192_0.gif" alt="Image Description" /></td> <td><img src="./figures/synthetic_sample/synthetic_video_197_0.gif" alt="Image Description" /></td> </tr> </table>

Training

Download Foundational Models

Download the foundational models and place them in the pretrained_models folder.

Download Synthetic Video Dataset

See download link in the third party reproduction

Train the Model

Put the synthetic video dataset in the video_ptp folder.

Run the following command to train the model:

python main.py --config configs/instruct_v2v.yaml -r # add -r to resume training if the training is interrupted

Create Synthetic Video Dataset

If you want to create your own synthetic video dataset, please follow the instructions

vae_ckpt = 'VAE_PATH'
unet_ckpt = 'UNet_PATH'
text_model_ckpt = 'Text_MODEL_PATH'
python video_prompt_to_prompt.py 
    --start [START INDEX] \
    --end [END INDEX] \
    --prompt_source [ip2p or webvid] \
    --num_sample_each_prompt [NUM SAMPLES FOR EACH PROMPT]

Visual Comparison to Other Methods

https://github.com/amazon-science/instruct-video-to-video/assets/20940184/d3619652-dd75-41a0-92b4-345bbf57de40

Links to the baselines used in the video:

| Tune-A-Video | Control Video | Vid2Vid Zero | Video P2P |

| TokenFlow | Render A Video | Pix2Video |

Credit

The code was implemented by Jiaxin Cheng during his internship at the AWS Shanghai Lablet.

References

Part of the code and the foundational models are adapted from the following works: