jayPark777/MiniMax-Music-3-3Trit-MLQT

🎵 MiniMax Music 3 (Axon MLQT v1.1a · Dual-Block BLK32/BLK64 Packed Edition)

Engineered by Axon Labs — 3-Trit Ternary Quantization + 0-SKIP Sparsity + Outlier-Preserving Dual-Block Routing

💡 Overview

MiniMax Music 3 풀송 생성 모델의 검증 완료(v1.1a) 패킹 양자화 가중치. 모든 수치는 2026-08-26 실측값입니다 (RTX 3060 12GB / ComfyUI 0.33.0).

Component	Original	MLQT v1.1a Packed	Ratio
DiT (diffusion transformer)	4.58 GB (FP16)	0.67 GB	14.7%
Text Encoder & AR Qwen3	8.57 GB (INT8 convrot)	3.56 GB	41.6%
Audio VAE (dav)	0.20 GB	0.20 GB (무손실 보존)	100%
Total weights	13.35 GB	4.43 GB	66.8% 절감

라우팅 헌장 (Dual-Block)

• BLK32 정밀 (블록당 독립 스케일): 오디오/보컬/크로스 어텐션 경로 — audio 포함 텐서 최우선, attention 계열, 미분류 텐서(안전 기본)
• BLK64 초경량: FFN/MLP 대형 행렬 (ffn, mlp.*, ff.*, gate_/up_/down_proj, gate_up)
• 민감 텐서(norm/bias/embed/head/tokenizer_json U8)는 원본 dtype 무손실 보존

✅ 독립 검증 성적표 (제작자 클레임 아닌 제3자 도구 감사)

Gate	결과
safetensors 표준 헤더 역직렬화	PASS (DiT/TE)
패킹 바이트 수학 (codes=ceil(numel×2bit/8), scales=n_blocks)	PASS (149+161 그룹)
라우팅 실측 vs 메타 클레임 드리프트	0
int8 디콘 정합성 (vs 원본 bf16, down_proj)	cosine 0.999956
tokenizer_json dtype 보존	U8 유지 PASS
실생성 음향 ('멈춰버린 시계들' 60s)	클리핑 0건 · 무음비 0.14% · Peak −7.7 dBFS · RMS −24.74 dBFS · 크레스트 17.03 dB

🚀 Quick Start (ComfyUI)

1. 커스텀 노드 설치: ComfyUI-MiniMaxMusic3-MLQT → custom_nodes/
2. 배치:
   • minimax_music3_dit_3trit_0skip_mlqt.safetensors → models/diffusion_models/
   • minimax_music3_text_encoder_3trit_0skip_mlqt.safetensors → models/text_encoders/
   • minimax_music3_dav.safetensors → models/vae/
3. 워크플로우에서 MiniMax Music 3 (MLQT Direct Loader) 로 세 파일 선택 후 Queue.
   • 노드가 .mlqt_trits 패킹을 자동 감지 → 로드 시 dense fp16으로 복원(기존 추론 경로 호환).

📐 파일 포맷 (v1.1a Packed, 표준 safetensors)

<key>.mlqt_trits : U8  2-bit 코드 ×4/바이트 ({0:-1, 1:0, 2:+1})
<key>.mlqt_scale : F16 블록별 alpha
<key>.mlqt_shape : I32 논리 shape
<key>.mlqt_meta  : U8  JSON {"numel": N, "block": 32|64}

⏱️ 생성 시간 실측 (RTX 3060 12GB, 저VRAM 오프로드 활성)

60초 곡 기준: AR 토큰 약 27분 48초 + DiT 25스텝 약 2분 30초 + VAE 디코드. ※ 오프로드 비활성 환경(여유 VRAM ≥ 11GB)에서는 유의하게 단축될 수 있음.

🧾 정직한 벤치마크 노트

과거 공개 클레임(10분 생성 등)은 INT8 경로 기준 추정치로 확인되며, 본 릴리즈부터는 위 실측값만 사용합니다. 재현 스크립트: verify_mlqt_v11a.py, run_masterpiece_mlqt_verify.py.

---

💼 Axon Labs Enterprise Quantization Services

• Website: https://axonlabs.ai · Contact: contact@axonlabs.ai