Text-to-Video
Sana
English
Chinese
image-to-video
SANA
SANA-Video
SANA-Video-2.0
720p
diffusion
LTX-2.3
Instructions to use Efficient-Large-Model/SANA-Video_2.0_5B_720p with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Sana
How to use Efficient-Large-Model/SANA-Video_2.0_5B_720p with Sana:
# Load the model and infer image from text import torch from app.sana_pipeline import SanaPipeline from torchvision.utils import save_image sana = SanaPipeline("configs/sana_config/1024ms/Sana_1600M_img1024.yaml") sana.from_pretrained("hf://Efficient-Large-Model/SANA-Video_2.0_5B_720p") image = sana( prompt='a cyberpunk cat with a neon sign that says "Sana"', height=1024, width=1024, guidance_scale=5.0, pag_guidance_scale=2.0, num_inference_steps=18, ) - Notebooks
- Google Colab
- Kaggle
File size: 7,241 Bytes
7497331 a5e7426 7497331 a5e7426 7497331 a5e7426 7497331 a5e7426 7497331 a5e7426 7497331 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | ---
license: apache-2.0
library_name: sana
pipeline_tag: text-to-video
language:
- en
- zh
tags:
- text-to-video
- image-to-video
- SANA
- SANA-Video
- SANA-Video-2.0
- 720p
- diffusion
- LTX-2.3
---
# SANA-Video 2.0 5B 720p
SANA-Video 2.0 is an efficient diffusion transformer for high-resolution video
generation. This release provides the 5B-class checkpoint jointly post-trained
for text-to-video (T2V) and text-image-to-video (TI2V) generation at 720p for
about eight seconds.
The model combines gated bidirectional linear-attention layers with periodic
dense softmax-attention anchors and shared Attention Residual aggregation. It
uses Gemma 2 2B IT for text conditioning and the LTX 2.3 VAE contract with 128
latent channels and `(8, 32, 32)` temporal/spatial compression.
## Model details
| Property | Value |
| --- | --- |
| Architecture | `SanaVideo2_5B` |
| Parameters | 4,466,980,960 trainable model parameters (4.47B) |
| Transformer | 32 layers, hidden size 2,560 |
| Attention | 75% gated linear attention, 25% dense softmax anchors |
| Attention Residuals | Shared, timestep-independent aggregation every 8 layers |
| Tasks | Text-to-video and text-image-to-video |
| Output bucket | 736 × 1280, 193 frames, 24 FPS (about 8 seconds) |
| Text encoder | `google/gemma-2-2b-it` |
| VAE | LTX 2.3, 128 latent channels, stride `(8, 32, 32)` |
| Recommended inference | BF16, CFG 8, flow shift 12, 50 steps, motion score 20 |
| License | Apache 2.0 |
The checkpoint is an inference artifact containing only the merged model
`state_dict`. It does not contain optimizer, scheduler, training-state, or
standalone LoRA tensors. The EMA base weights and ReFL post-training adapter
were merged before release. Stored tensors retain their merged source dtypes;
the official inference entry point casts the transformer to BF16.
## Files
- `checkpoints/SANA_Video_2.0_5B_720p.pth`: merged transformer checkpoint
- `config.yaml`: matching SANA training and inference configuration
- `LICENSE`: Apache License 2.0
Checkpoint SHA256:
```text
7e557554540b4cbbc515166b43a7d307285ab250cedfb48627878227a722d25a
```
## Verified release example
This sample was generated from the public checkpoint with seed 0. The encoded
result is 1280 × 736, 193 frames, 24 FPS, and 8.04 seconds long.
<p align="center">
<a href="https://huggingface.co/datasets/Efficient-Large-Model/Sana-assets/resolve/main/Video2/assets/release-demo/sana_video2_5b_720p_rooster.mp4">
<img src="https://huggingface.co/datasets/Efficient-Large-Model/Sana-assets/resolve/main/Video2/assets/release-demo/sana_video2_5b_720p_rooster_poster.png" width="90%" alt="SANA-Video 2.0 5B release demo: a cartoon rooster holding a beer bottle in a floral vintage room"/>
</a>
</p>
<p align="center">
<a href="https://huggingface.co/datasets/Efficient-Large-Model/Sana-assets/resolve/main/Video2/assets/release-demo/sana_video2_5b_720p_rooster.mp4">▶ Watch or download the generated video</a>
</p>
> **Prompt:** In a cozy, vintage room adorned with floral wallpaper, a cartoon
> rooster sits comfortably in a floral-patterned armchair, sipping from a bottle
> of beer. The rooster, with its vibrant red comb and wattle, displays a range of
> expressions—smiling, nodding, and opening its beak wide in a cheerful manner.
> The setting includes wooden furniture and another beer bottle on the table,
> adding to the relaxed atmosphere. The camera captures the rooster from a
> close-up angle, emphasizing its animated movements and lively demeanor.
## Inference
Support for this checkpoint is provided by the SANA-Video 2.0 release branch
while [NVlabs/Sana PR #439](https://github.com/NVlabs/Sana/pull/439) is under
review:
```bash
git clone https://github.com/NVlabs/Sana.git
cd Sana
git checkout release/sana-video-2.0
bash environment_setup.sh sana
conda activate sana
```
Place the Diffusers-format LTX 2.3 VAE at
`output/pretrained_models/LTX-2.3-Diffusers/`, or update
`vae.vae_pretrained` in `config.yaml`.
### Text-to-video
The command below is the exact command used for the verified release example:
```bash
bash inference_video_scripts/inference_sana_video.sh \
--np 1 \
--config configs/sana_video2/SanaVideo2_5B_720p.yaml \
--model_path hf://Efficient-Large-Model/SANA-Video_2.0_5B_720p/checkpoints/SANA_Video_2.0_5B_720p.pth \
--txt_file=asset/samples/sana_video2_5b_720p_demo.txt \
--cfg_scale 8 \
--flow_shift 12 \
--step 50 \
--fps 24 \
--motion_score 20 \
--seed 0 \
--work_dir output/sana_video2_t2v_720p_demo
```
### Text-image-to-video
Each line in `asset/samples/sample_i2v.txt` contains a prompt and an input-image
path separated by `<image>`.
```bash
bash inference_video_scripts/inference_sana_video.sh \
--np 1 \
--config configs/sana_video2/SanaVideo2_5B_720p.yaml \
--model_path hf://Efficient-Large-Model/SANA-Video_2.0_5B_720p/checkpoints/SANA_Video_2.0_5B_720p.pth \
--txt_file=asset/samples/sample_i2v.txt \
--task=ltx \
--cfg_scale 8 \
--flow_shift 12 \
--step 50 \
--fps 24 \
--motion_score 20 \
--work_dir output/sana_video2_ti2v_720p
```
The default 720p bucket is 736 × 1280 because both spatial dimensions must be
divisible by 32. Frame counts must satisfy `(num_frames - 1) % 8 == 0`.
## Intended use
This model is intended for research, evaluation, and creative generation of
short videos from text, with optional first-frame image conditioning. It can
also serve as a starting point for domain-specific fine-tuning under the
license terms.
The model is not intended to produce factual evidence, identify people, make
high-impact automated decisions, or generate content that violates privacy,
copyright, applicable law, or platform policies.
## Limitations and bias
- Generated motion, anatomy, text rendering, object permanence, and physical
interactions may be inconsistent, especially for crowded or highly dynamic
scenes.
- Prompt following can degrade for long, ambiguous, or compositionally complex
instructions.
- Image-conditioned generation can drift from fine details in the source image.
- Outputs can reflect social and cultural biases present in training data and
in the separately loaded text encoder.
- The model does not independently verify whether generated content is factual,
safe, or free of third-party rights.
Users should review outputs before publication, disclose synthetic media where
appropriate, and add safeguards suited to their application.
## Resources
- [SANA repository](https://github.com/NVlabs/Sana)
- [SANA-Video 2.0 release PR](https://github.com/NVlabs/Sana/pull/439)
- [SANA-Video 2.0 documentation](https://github.com/NVlabs/Sana/blob/release/sana-video-2.0/docs/sana_video2.md)
- [Model zoo](https://github.com/NVlabs/Sana/blob/release/sana-video-2.0/docs/model_zoo.md#sana-video-20)
- [Verified 5B 720p release video](https://huggingface.co/datasets/Efficient-Large-Model/Sana-assets/resolve/main/Video2/assets/release-demo/sana_video2_5b_720p_rooster.mp4)
## Citation
If you use SANA-Video, please cite the SANA-Video work linked from the
[project page](https://nvlabs.github.io/Sana/Video/). SANA-Video 2.0-specific
citation information will be added when it becomes available.
|