File size: 4,656 Bytes
75487f8 4084afa 75487f8 4084afa 75487f8 9dfbf10 4084afa 9dfbf10 4084afa 9dfbf10 4084afa 75487f8 | 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 | # Modified files
Section III.2 of the MiniMax H3 Community License Agreement requires that modified
files carry a prominent notice saying so. This file is that notice.
Everything below is derived from
[`MiniMaxAI/MiniMax-H3`](https://huggingface.co/MiniMaxAI/MiniMax-H3).
## `transformer/` — modified
**Every weight file in `transformer/` has been modified.** It started as the base
model's `transformer_ref/` (the `ref2va` transformer, 33.1 B parameters) and every
parameter was updated by a full finetune on a character-replacement objective. The
architecture, `config.json` and tensor names are unchanged, so it is a drop-in
replacement for the base `transformer_ref/`; the numbers in it are not the base
model's numbers.
The file layout also differs: the finetune was written as one 61.7 GiB safetensors
file and re-sharded here into 14 parts, because HuggingFace rejects single files
above 50 GB. The 638 tensors and their contents are unchanged by that re-sharding.
## `lora/pytorch_lora_weights.safetensors` — new
Not a MiniMax file. A rank-128 LoRA over 302 linear layers of `transformer/`,
trained by us with DMD2 distillation. It is a delta on the finetuned transformer
above, not on the base model — loading it onto stock `transformer_ref/` produces
garbage.
## `assets/fixed_embed_fwd_anyframe.pt` — new
Not a MiniMax file. A frozen 362 × 5120 text-conditioning tensor we computed once
with the base model's own text encoder, so that inference never has to load
Qwen3-VL. It is an *output* of the base model's encoder in the sense of Section
I.12, computed from the prompt in `assets/fixed_prompt.txt`.
## `assets/fixed_prompt.txt` — new
Not a MiniMax file. The prompt text the tensor above was computed from, included so
that what conditions every render is readable rather than opaque.
## `inference/sample.py`, `examples/demo.sh` — new
Not MiniMax files. Written by us against the public `diffusers` API.
## `LICENSE-CODE`, `NOTICE` — new
Not MiniMax files. `LICENSE-CODE` is the Apache 2.0 text, and it covers `inference/` and
`examples/` only — each file there carries an `SPDX-License-Identifier: Apache-2.0` header.
`NOTICE` records that the weights are *not* Apache 2.0. `LICENSE` is the MiniMax H3
Community License Agreement itself, included unmodified as Section III.1 requires.
## `examples/media/` — new
Two kinds of media here, with different provenance.
**The demo** — `reference.png`, `output.mp4`, `before-after.png` — derives from
`assets/ref2va.mp4`, a video MiniMax published with the base model. That clip is itself a
MiniMax H3 generation rather than camera footage. All three files are a 512 × 768 portrait
crop of it (`crop=512:768:389:0`, no scaling):
- `reference.png` — the crop's first frame with the young man repainted as an invented
elderly woman. Produced with OpenAI's `gpt-image-2`; the character is fictional and is
not a real person or an existing property.
- `output.mp4` — that reference propagated across 124 frames by this model.
- `before-after.png` — frames from the driving crop above frames from the output.
The driving clip itself is **not** bundled. `examples/demo.sh` rebuilds it, with the
documented crop, from your own copy of the base model.
**The comparison clips** — `compare-prop.mp4`, `compare-costume.mp4`, `compare-style.mp4` — are a
different matter. Their driving videos are
real filmed footage that we hold the rights to, and they are among the clips this model was
evaluated against. Each file is a four-panel stack: painted reference, driving video, this model,
Wan2.2-Animate-14B. The Wan2.2-Animate panels were rendered by us from the official
[`Wan-AI/Wan2.2-Animate-14B`](https://huggingface.co/Wan-AI/Wan2.2-Animate-14B) weights and code,
unmodified, at the replacement-mode settings its own README documents (20 steps, `sample_shift 5.0`,
`--refert_num 1 --replace_flag --use_relighting_lora`, preprocessing at `--w_len 1 --h_len 1`) —
that panel is Wan's output, not ours.
Wan's `generate.py` hardcodes a 30 fps output timebase regardless of the source, so its raw files
claim 4.10 s for motion that is 24 fps. The panels are retimed (`setpts`), not resampled, so no
frames are dropped and both models play at the same speed. Every panel is letterboxed into the
driving clip's own geometry; nothing is stretched.
## Not redistributed here
The VAE, audio VAE, schedulers, text encoder, tokenizer and processor are **not**
included in this repository and are not modified. They are loaded at runtime from
your own copy of `MiniMaxAI/MiniMax-H3`, which you must download separately and
under its own license terms.
|