CLI

CLI notes (HIP)

./h3 --help is the full list. Flags that change quality, speed, or HIP behaviour:

Flag	Meaning
-d, --model-dir	MiniMax-H3 directory
-p, --prompt	Raw H3 prompt
-o, --output	MP4 (default outputs/h3.mp4)
--width / --height	Output size (defaults 864×480)
--frames / --seconds	Duration; --seconds is at 24 fps
--steps	Euler passes (default 20)
--layers	DiT blocks: 50 exact, 45 fast, 40 aggressive
--reuse	Denoiser reuse: 1 close, 2 fast, 3 aggressive
--token-reduction	Pair video tokens in middle DiT blocks
--seed	Default 42
--first-frame / --last-frame	FL2VA stills
--ref-image	Ordered Ref2VA image (repeatable)
--ref-image-size	match (default) or max
--ref-video / --ref-silent-video / --ref-audio	Other Ref2VA inputs
--ref-video-audio VIDEO AUDIO	Video + separate soundtrack
--frames-dir	Dump PPM frames
--show	Live denoise preview in supported terminals
--profile	Phase + op-class GPU timing
--ssd-streaming	Stream BF16 DiT layers from SSD (not used in fox benches)

--ref-video with an embedded soundtrack needs at least 2 seconds of audio (request --frames 56 or more).

fox-s2 vs fox-fast

Both are T2VA fox presets at 512² / 22 frames. They are not the same as the README fox showcase (--layers 50 --reuse 1).

• fox-s2: --steps 2 --layers 35 --reuse 1 — HIP A/B and md5.
• fox-fast: --steps 20 --layers 45 --reuse 2 — 11 DiT evals; apples-to-apples with upstream’s “first fast video” denoise wall.

See Performance.