Text-to-Video
Diffusers
Safetensors
MiniMax H3
video
audio
text-to-audio-video
distillation
dmd2
few-step
fastvideo
fasth3
Instructions to use FastVideo/FastVideo-FastH3-8-Step-V2 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use FastVideo/FastVideo-FastH3-8-Step-V2 with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("FastVideo/FastVideo-FastH3-8-Step-V2", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
library_name: diffusers (match 4-step card, enable download tracking); remove provenance.json and private-era docs
Browse filesDocumentation/metadata only: no weights, scheduler configs, modular_model_index.json or fastvideo_inference.json changed.
- INFERENCE.md +0 -53
- README.md +1 -1
- RELEASE_CHECKLIST.md +0 -49
- provenance.json +0 -33
INFERENCE.md
DELETED
|
@@ -1,53 +0,0 @@
|
|
| 1 |
-
# FastH3 8-Step V2 inference
|
| 2 |
-
|
| 3 |
-
## Compatibility status
|
| 4 |
-
|
| 5 |
-
FastVideo [PR #1852](https://github.com/hao-ai-lab/FastVideo/pull/1852) adds
|
| 6 |
-
the runtime support this checkpoint needs: scheduler shifts are read from the
|
| 7 |
-
checkpoint (video 10, audio 3 here; base H3 keeps 12/3), the eight-rung DMD
|
| 8 |
-
ladder is loaded from `fastvideo_inference.json`, and a new
|
| 9 |
-
`examples/inference/basic/basic_fasth3_8step.py` example pins the recipe.
|
| 10 |
-
Public `main` before that PR hard-codes video shift 12 and cannot run this
|
| 11 |
-
checkpoint unchanged.
|
| 12 |
-
|
| 13 |
-
## Exact sampling contract
|
| 14 |
-
|
| 15 |
-
- Unshifted student inputs: `[999, 874, 749, 624, 500, 375, 250, 125]`.
|
| 16 |
-
- The terminal clean endpoint is zero: eight model evaluations, nine grid nodes.
|
| 17 |
-
- Video shift: `10`; audio shift: `3`; guidance: `1.0`.
|
| 18 |
-
- Backend: `VIDEO_SPARSE_ATTN_H3`; sparsity: `0.8`; tile size: `64`.
|
| 19 |
-
- Sampling: ODE updates, without stochastic re-noising.
|
| 20 |
-
- Full H3 video and audio VAEs; preserve the output audio track.
|
| 21 |
-
|
| 22 |
-
`--steps 9` alone is not equivalent to the explicit trained ladder.
|
| 23 |
-
The environment variable below supplies the exact integer rungs; the two
|
| 24 |
-
scheduler shifts must also be applied. `fastvideo_inference.json` records
|
| 25 |
-
the same settings; verify that your launcher applies them rather than
|
| 26 |
-
assuming its defaults match this file.
|
| 27 |
-
|
| 28 |
-
## Command
|
| 29 |
-
|
| 30 |
-
On the PR #1852 branch (or `main` once merged), on a GPU worker:
|
| 31 |
-
|
| 32 |
-
```bash
|
| 33 |
-
python examples/inference/basic/basic_fasth3_8step.py \
|
| 34 |
-
--prompt 'integrated_multimodal_description: A red fox runs through fresh snow at dawn. overall_soundscape: Fast pawsteps in snow, winter wind, and distant birds.' \
|
| 35 |
-
--height 768 --width 1344 --num-frames 124 \
|
| 36 |
-
--num-gpus 4 --vsa-kernel sm100a \
|
| 37 |
-
--profile strict --no-inference-torch-compile --no-compile-vae \
|
| 38 |
-
--output outputs/fasth3-v2 \
|
| 39 |
-
--repeats 1
|
| 40 |
-
```
|
| 41 |
-
|
| 42 |
-
No environment variables are needed: the example reads the ladder and shifts
|
| 43 |
-
from the checkpoint and rejects any `--steps` other than 9.
|
| 44 |
-
|
| 45 |
-
This example requests 1344×768, 124 frames at 24 fps (about 5.17 seconds),
|
| 46 |
-
and writes MP4s with a stereo 32 kHz audio track under `outputs/fasth3-v2/`. The `sm100a` route needs a compatible
|
| 47 |
-
Blackwell GPU and kernel build. Triton is a different kernel option, not a
|
| 48 |
-
license to change the trained sparsity, tile geometry, or shifts.
|
| 49 |
-
|
| 50 |
-
Verified on the PR #1852 head on 4x GB200: eight student forwards,
|
| 51 |
-
video/audio shifts 10/3, VSA 0.8 tile 64, and a playable MP4 with audio
|
| 52 |
-
(832x480, 124 frames). Report any latency with the exact hardware,
|
| 53 |
-
resolution, frame count, attention path and warmup policy.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
README.md
CHANGED
|
@@ -3,7 +3,7 @@ license: other
|
|
| 3 |
license_name: minimax-h3-community
|
| 4 |
license_link: LICENSE
|
| 5 |
base_model: MiniMaxAI/MiniMax-H3
|
| 6 |
-
library_name:
|
| 7 |
pipeline_tag: text-to-video
|
| 8 |
tags:
|
| 9 |
- text-to-video
|
|
|
|
| 3 |
license_name: minimax-h3-community
|
| 4 |
license_link: LICENSE
|
| 5 |
base_model: MiniMaxAI/MiniMax-H3
|
| 6 |
+
library_name: diffusers
|
| 7 |
pipeline_tag: text-to-video
|
| 8 |
tags:
|
| 9 |
- text-to-video
|
RELEASE_CHECKLIST.md
DELETED
|
@@ -1,49 +0,0 @@
|
|
| 1 |
-
# FastH3 8-Step V2 release checklist
|
| 2 |
-
|
| 3 |
-
Prepared 2026-09-08; updated 2026-09-15 after the repository was made public and FastVideo PR #1852 was opened.
|
| 4 |
-
|
| 5 |
-
## Verified packaging
|
| 6 |
-
|
| 7 |
-
- [x] Canonical repo: `FastVideo/FastVideo-FastH3-8-Step-V2`; private visibility retained.
|
| 8 |
-
- [x] Model card identifies the step-1300 V14 data-free DMD2 model, VSA80/tile64,
|
| 9 |
-
eight forwards and video/audio shifts 10/3.
|
| 10 |
-
- [x] FastVideo logo, blog, code, method citations and linked acknowledgements included.
|
| 11 |
-
- [x] All indexed shards exist: 14 transformer, 14 text-encoder, 3 video-VAE;
|
| 12 |
-
the single-file audio VAE is also present.
|
| 13 |
-
- [x] All 14 student shard sizes and SHA-256 values in `checkpoint_content.json`
|
| 14 |
-
match the Hub file/LFS metadata. No large weight download was required.
|
| 15 |
-
- [x] The preserved `checkpoint_metadata.json` SHA-256 matches provenance.
|
| 16 |
-
- [x] `LICENSE` matches the pinned MiniMax H3 base revision exactly.
|
| 17 |
-
- [x] Added the MiniMax redistribution `NOTICE` and Qwen3-VL Apache-2.0 license.
|
| 18 |
-
- [x] Model card and embedded repository references use the V2 name.
|
| 19 |
-
|
| 20 |
-
The audited package revision before these documentation changes was
|
| 21 |
-
`a001692841117d7d04707951db28b12187f81c66` (67 files, 147,870,260,063 bytes).
|
| 22 |
-
The student contains 688 bf16 tensors. Documentation updates must not alter
|
| 23 |
-
checkpoint weights, scheduler settings or original provenance hashes.
|
| 24 |
-
|
| 25 |
-
## Required before publishing
|
| 26 |
-
|
| 27 |
-
- [x] Land or provide a reviewed public FastVideo inference path for video shift
|
| 28 |
-
10 and the exact eight-rung ladder. Open as FastVideo PR #1852 (not yet merged). Public `main` at
|
| 29 |
-
`a943220c115228ade5d57b3bab9a6a87fd600a10` still hard-codes video shift 12;
|
| 30 |
-
the old README's scheduler-shift CLI options are absent there.
|
| 31 |
-
- [x] Replace the compatibility hold with a verified public quickstart
|
| 32 |
-
(`basic_fasth3_8step.py`, PR #1852).
|
| 33 |
-
- [x] Run one end-to-end GPU generation using the PR #1852 head; confirmed
|
| 34 |
-
eight forwards, shifts 10/3, VSA80/tile64 and playable video with audio
|
| 35 |
-
(4x GB200, 832x480x124f). Re-verify on `main` after merge.
|
| 36 |
-
- [ ] Inspect representative high-motion samples. Do not copy the four-step
|
| 37 |
-
models' evaluation results or speed claims onto this checkpoint.
|
| 38 |
-
- [ ] Complete author/legal review of the MiniMax H3 territory, redistribution
|
| 39 |
-
and commercial terms, including any required separate authorization.
|
| 40 |
-
Adding license notices is not legal clearance for worldwide distribution.
|
| 41 |
-
- [ ] Review the historical cluster paths and run identifiers in the preserved
|
| 42 |
-
provenance files before publication. No credentials were found in the
|
| 43 |
-
reviewed metadata, but provenance sanitization would require updating the
|
| 44 |
-
corresponding integrity references deliberately.
|
| 45 |
-
- [x] Repository made public by the author on 2026-09-15.
|
| 46 |
-
|
| 47 |
-
Qwen license source:
|
| 48 |
-
`https://github.com/QwenLM/Qwen3-VL/blob/96588727e44c78b25ba03ea03b8e12f7e64fd0da/LICENSE`.
|
| 49 |
-
Runtime details and the compatible private-review command are in `INFERENCE.md`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
provenance.json
DELETED
|
@@ -1,33 +0,0 @@
|
|
| 1 |
-
{
|
| 2 |
-
"attention_backend": "VIDEO_SPARSE_ATTN_H3",
|
| 3 |
-
"audio_scheduler_shift": 3.0,
|
| 4 |
-
"base_model": "hf://MiniMaxAI/MiniMax-H3@9bfb6693f2cf6de171db46d1aa586f67d773a1da",
|
| 5 |
-
"checkpoint_content_sha256": "516323fa396fa5dff4e82669d4e9a08a5791692a3d3b98ff6bc3de3fc6a33d11",
|
| 6 |
-
"checkpoint_metadata_sha256": "ca9f2d609c05742ba465d24989981ec02cca26acb6ca2f163dc0f6dc8d11c27b",
|
| 7 |
-
"checkpoint_step": 1300,
|
| 8 |
-
"data_commit": "b92be606a439c67006220459df236d18c48fd38c3e11f4771d21fe0d078a3371",
|
| 9 |
-
"dmd_denoising_steps": [
|
| 10 |
-
999,
|
| 11 |
-
874,
|
| 12 |
-
749,
|
| 13 |
-
624,
|
| 14 |
-
500,
|
| 15 |
-
375,
|
| 16 |
-
250,
|
| 17 |
-
125
|
| 18 |
-
],
|
| 19 |
-
"fastvideo_commit": "24bbe7fddd05ca6f2c34b3dbed06ac1c75b72086",
|
| 20 |
-
"lineage_parent_run_id": "20260829T023805Z-h3-8step-datafree-vsa80-vshift8",
|
| 21 |
-
"model_id": "FastVideo/FastVideo-FastH3-8-Step-V2",
|
| 22 |
-
"schema_version": "fasth3-checkpoint-provenance-v1",
|
| 23 |
-
"source_config_sha256": "92a4c5f2ece19d71929903d7cc094eecada3a768c9a8f846001b6610e02ff6df",
|
| 24 |
-
"student_dtype": "bfloat16",
|
| 25 |
-
"student_tensor_bytes": 70099502592,
|
| 26 |
-
"student_tensor_count": 688,
|
| 27 |
-
"training_mode": "data-free",
|
| 28 |
-
"training_run_id": "20260829T210445Z-h3-v14-8step-datafree-vsa80-vshift10",
|
| 29 |
-
"video_scheduler_shift": 10.0,
|
| 30 |
-
"vsa_sparsity": 0.8,
|
| 31 |
-
"vsa_tile_size": 64,
|
| 32 |
-
"wandb_url": "https://wandb.ai/wlsaidhi/h3-dmd2-vsa/runs/euce1zuw"
|
| 33 |
-
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|