Update README.md
#54
by
Abhikpal
- opened
README.md
CHANGED
@@ -1,95 +0,0 @@
|
|
1 |
-
---
|
2 |
-
pipeline_tag: image-to-video
|
3 |
-
license: other
|
4 |
-
license_name: stable-video-diffusion-nc-community
|
5 |
-
license_link: LICENSE
|
6 |
-
---
|
7 |
-
|
8 |
-
# Stable Video Diffusion Image-to-Video Model Card
|
9 |
-
|
10 |
-
<!-- Provide a quick summary of what the model is/does. -->
|
11 |
-
![row01](output_tile.gif)
|
12 |
-
Stable Video Diffusion (SVD) Image-to-Video is a diffusion model that takes in a still image as a conditioning frame, and generates a video from it.
|
13 |
-
|
14 |
-
## Model Details
|
15 |
-
|
16 |
-
### Model Description
|
17 |
-
|
18 |
-
(SVD) Image-to-Video is a latent diffusion model trained to generate short video clips from an image conditioning.
|
19 |
-
This model was trained to generate 25 frames at resolution 576x1024 given a context frame of the same size, finetuned from [SVD Image-to-Video [14 frames]](https://huggingface.co/stabilityai/stable-video-diffusion-img2vid).
|
20 |
-
We also finetune the widely used [f8-decoder](https://huggingface.co/docs/diffusers/api/models/autoencoderkl#loading-from-the-original-format) for temporal consistency.
|
21 |
-
For convenience, we additionally provide the model with the
|
22 |
-
standard frame-wise decoder [here](https://huggingface.co/stabilityai/stable-video-diffusion-img2vid-xt/blob/main/svd_xt_image_decoder.safetensors).
|
23 |
-
|
24 |
-
|
25 |
-
- **Developed by:** Stability AI
|
26 |
-
- **Funded by:** Stability AI
|
27 |
-
- **Model type:** Generative image-to-video model
|
28 |
-
- **Finetuned from model:** SVD Image-to-Video [14 frames]
|
29 |
-
|
30 |
-
### Model Sources
|
31 |
-
|
32 |
-
For research purposes, we recommend our `generative-models` Github repository (https://github.com/Stability-AI/generative-models),
|
33 |
-
which implements the most popular diffusion frameworks (both training and inference).
|
34 |
-
|
35 |
-
- **Repository:** https://github.com/Stability-AI/generative-models
|
36 |
-
- **Paper:** https://stability.ai/research/stable-video-diffusion-scaling-latent-video-diffusion-models-to-large-datasets
|
37 |
-
|
38 |
-
|
39 |
-
## Evaluation
|
40 |
-
![comparison](comparison.png)
|
41 |
-
The chart above evaluates user preference for SVD-Image-to-Video over [GEN-2](https://research.runwayml.com/gen2) and [PikaLabs](https://www.pika.art/).
|
42 |
-
SVD-Image-to-Video is preferred by human voters in terms of video quality. For details on the user study, we refer to the [research paper](https://stability.ai/research/stable-video-diffusion-scaling-latent-video-diffusion-models-to-large-datasets)
|
43 |
-
|
44 |
-
## Uses
|
45 |
-
|
46 |
-
### Direct Use
|
47 |
-
|
48 |
-
The model is intended for research purposes only. Possible research areas and tasks include
|
49 |
-
|
50 |
-
- Research on generative models.
|
51 |
-
- Safe deployment of models which have the potential to generate harmful content.
|
52 |
-
- Probing and understanding the limitations and biases of generative models.
|
53 |
-
- Generation of artworks and use in design and other artistic processes.
|
54 |
-
- Applications in educational or creative tools.
|
55 |
-
|
56 |
-
Excluded uses are described below.
|
57 |
-
|
58 |
-
### Out-of-Scope Use
|
59 |
-
|
60 |
-
The model was not trained to be factual or true representations of people or events,
|
61 |
-
and therefore using the model to generate such content is out-of-scope for the abilities of this model.
|
62 |
-
The model should not be used in any way that violates Stability AI's [Acceptable Use Policy](https://stability.ai/use-policy).
|
63 |
-
|
64 |
-
## Limitations and Bias
|
65 |
-
|
66 |
-
### Limitations
|
67 |
-
- The generated videos are rather short (<= 4sec), and the model does not achieve perfect photorealism.
|
68 |
-
- The model may generate videos without motion, or very slow camera pans.
|
69 |
-
- The model cannot be controlled through text.
|
70 |
-
- The model cannot render legible text.
|
71 |
-
- Faces and people in general may not be generated properly.
|
72 |
-
- The autoencoding part of the model is lossy.
|
73 |
-
|
74 |
-
|
75 |
-
### Recommendations
|
76 |
-
|
77 |
-
The model is intended for research purposes only.
|
78 |
-
|
79 |
-
## How to Get Started with the Model
|
80 |
-
|
81 |
-
Check out https://github.com/Stability-AI/generative-models
|
82 |
-
|
83 |
-
# Appendix:
|
84 |
-
|
85 |
-
All considered potential data sources were included for final training, with none held out as the proposed data filtering methods described in the SVD paper handle the quality control/filtering of the dataset. With regards to safety/NSFW filtering, sources considered were either deemed safe or filtered with the in-house NSFW filters.
|
86 |
-
No explicit human labor is involved in training data preparation. However, human evaluation for model outputs and quality was extensively used to evaluate model quality and performance. The evaluations were performed with third-party contractor platforms (Amazon Sagemaker, Amazon Mechanical Turk, Prolific) with fluent English-speaking contractors from various countries, primarily from the USA, UK, and Canada. Each worker was paid $12/hr for the time invested in the evaluation.
|
87 |
-
No other third party was involved in the development of this model; the model was fully developed in-house at Stability AI.
|
88 |
-
Training the SVD checkpoints required a total of approximately 200,000 A100 80GB hours. The majority of the training occurred on 48 * 8 A100s, while some stages took more/less than that. The resulting CO2 emission is ~19,000kg CO2 eq., and energy consumed is ~64000 kWh.
|
89 |
-
The released checkpoints (SVD/SVD-XT) are image-to-video models that generate short videos/animations closely following the given input image. Since the model relies on an existing supplied image, the risk of disclosing specific material or novel unsafe content is minimal. This was also evaluated by third-party independent red-teaming services, which agree with our conclusion to a high degree of confidence (>90% in various areas of safety red-teaming). The external evaluations were also performed for trustworthiness, leading to >95% confidence in real, trustworthy videos.
|
90 |
-
With the default settings at the time of release, SVD takes ~100s for generation, and SVD-XT takes ~180s on an A100 80GB card. Several optimizations to trade off quality / memory / speed can be done to perform faster inference or inference on lower VRAM cards.
|
91 |
-
The information related to the model and its development process and usage protocols can be found in the GitHub repo, associated research paper, and HuggingFace model page/cards.
|
92 |
-
The released model inference & demo code has image-level watermarking enabled by default, which can be used to detect the outputs. This is done via the imWatermark Python library.
|
93 |
-
The model can be used to generate videos from static initial images. However, we prohibit unlawful, obscene, or misleading uses of the model consistent with the terms of our license. For the open-weights release, our training data filtering mitigations alleviate this to some extent. These restrictions are explicitly enforced on user-facing interfaces at stablevideo.com, where a warning is issued. We do not take any responsibility for third-party interfaces. Submitting initial images that bypass input filters to tease out offensive or inappropriate content listed above is also prohibited. Safety filtering checks at stablevideo.com run on model inputs and outputs independently. More details on our user-facing interfaces can be found here: https://www.stablevideo.com/faq
|
94 |
-
For stablevideo.com, we store preference data in the form of upvotes/downvotes on user-generated videos, and we have a pairwise ranker that runs while a user generates videos. This usage data is solely used for improving Stability AI’s future image/video models and services. No other third-party entities are given access to the usage data beyond Stability AI and maintainers of stablevideo.com.
|
95 |
-
For usage statistics of SVD, we refer interested users to HuggingFace model download/usage statistics as a primary indicator. Third-party applications also have reported model usage statistics. We might also consider releasing aggregate usage statistics of stablevideo.com on reaching some milestones.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|