|
--- |
|
license: cc-by-nc-4.0 |
|
tags: |
|
- text-to-video |
|
duplicated_from: diffusers/text-to-video-ms-1.7b-legacy |
|
--- |
|
|
|
# Text-to-video-synthesis Model in Open Domain |
|
|
|
This model is based on a multi-stage text-to-video generation diffusion model, which inputs a description text and returns a video that matches the text description. Only English input is supported. |
|
|
|
## Model description |
|
|
|
The text-to-video generation diffusion model consists of three sub-networks: text feature extraction model, text feature-to-video latent space diffusion model, and video latent space to video visual space model. The overall model parameters are about 1.7 billion. Currently, it only supports English input. The diffusion model adopts a UNet3D structure, and implements video generation through the iterative denoising process from the pure Gaussian noise video. |
|
|
|
This model is meant for research purposes. Please look at the [model limitations and biases and misuse](#model-limitations-and-biases), [malicious use and excessive use](#misuse-malicious-use-and-excessive-use) sections. |
|
|
|
## Model Details |
|
|
|
- **Developed by:** [ModelScope](https://modelscope.cn/) |
|
- **Model type:** Diffusion-based text-to-video generation model |
|
- **Language(s):** English |
|
- **License:**[ CC-BY-NC-ND](https://creativecommons.org/licenses/by-nc-nd/4.0/) |
|
- **Resources for more information:** [ModelScope GitHub Repository](https://github.com/modelscope/modelscope), [Summary](https://modelscope.cn/models/damo/text-to-video-synthesis/summary). |
|
- **Cite as:** |
|
|
|
## Use cases |
|
|
|
This model has a wide range of applications, and can reason and generate videos based on arbitrary English text descriptions. |
|
|
|
## Usage |
|
|
|
Let's first install the libraries required: |
|
|
|
```bash |
|
$ pip install git+https://github.com/huggingface/diffusers transformers accelerate |
|
``` |
|
|
|
Now, generate a video: |
|
|
|
```python |
|
import torch |
|
from diffusers import DiffusionPipeline, DPMSolverMultistepScheduler |
|
from diffusers.utils import export_to_video |
|
|
|
pipe = DiffusionPipeline.from_pretrained("damo-vilab/text-to-video-ms-1.7b-legacy", torch_dtype=torch.float16) |
|
pipe.scheduler = DPMSolverMultistepScheduler.from_config(pipe.scheduler.config) |
|
pipe.enable_cpu_model_offload() |
|
|
|
prompt = "Spiderman is surfing" |
|
video_frames = pipe(prompt, num_inference_steps=25).frames |
|
video_path = export_to_video(video_frames) |
|
``` |
|
|
|
Here are some results: |
|
|
|
<table> |
|
<tr> |
|
<td><center> |
|
An astronaut riding a horse. |
|
<br> |
|
<img src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/astr.gif" |
|
alt="An astronaut riding a horse." |
|
style="width: 300px;" /> |
|
</center></td> |
|
<td ><center> |
|
Darth vader surfing in waves. |
|
<br> |
|
<img src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/vader.gif" |
|
alt="Darth vader surfing in waves." |
|
style="width: 300px;" /> |
|
</center></td> |
|
</tr> |
|
</table> |
|
|
|
## View results |
|
|
|
The above code will display the save path of the output video, and the current encoding format can be played with [VLC player](https://www.videolan.org/vlc/). |
|
|
|
The output mp4 file can be viewed by [VLC media player](https://www.videolan.org/vlc/). Some other media players may not view it normally. |
|
|
|
## Model limitations and biases |
|
|
|
* The model is trained based on public data sets such as Webvid, and the generated results may have deviations related to the distribution of training data. |
|
* This model cannot achieve perfect film and television quality generation. |
|
* The model cannot generate clear text. |
|
* The model is mainly trained with English corpus and does not support other languages at the moment**. |
|
* The performance of this model needs to be improved on complex compositional generation tasks. |
|
|
|
## Misuse, Malicious Use and Excessive Use |
|
|
|
* The model was not trained to realistically represent people or events, so using it to generate such content is beyond the model's capabilities. |
|
* It is prohibited to generate content that is demeaning or harmful to people or their environment, culture, religion, etc. |
|
* Prohibited for pornographic, violent and bloody content generation. |
|
* Prohibited for error and false information generation. |
|
|
|
## Training data |
|
|
|
The training data includes [LAION5B](https://huggingface.co/datasets/laion/laion2B-en), [ImageNet](https://www.image-net.org/), [Webvid](https://m-bain.github.io/webvid-dataset/) and other public datasets. Image and video filtering is performed after pre-training such as aesthetic score, watermark score, and deduplication. |
|
|
|
_(Part of this model card has been taken from [here](https://huggingface.co/damo-vilab/modelscope-damo-text-to-video-synthesis))_ |
|
|
|
|
