MiniMax-Music3 README

The project's README from github.com/MiniMax-AI/MiniMax-Music3. As one markdown file: README.md.

MiniMax

MiniMax Agent API MiniMax Music 3 Live Demo MiniMax Website
ModelScope MiniMax AI WeChat Discord Hugging Face GitHub LICENSE

MiniMax Music 3

MiniMax Music 3 is a high-performance music generation model for creating complete songs up to five minutes long. Conditioned on lyrics and a detailed music description, it generates structurally coherent songs with expressive vocals, evolving arrangements, and stable long-form audio quality.

MiniMax Music 3 combines an 8B Global LLM for long-range musical structure, a 0.6B Local LLM for frame-level acoustic detail, and a continuous hidden-state synthesis system based on Flow Matching and Flow-VAE. The model produces 32 kHz, 16-bit stereo WAV audio.

Prompt Enhancement

A concise natural-language description can be used directly. For richer prompts and more precise control, use the provided music-caption-rewriter skill to expand it into a Structured Caption containing Global Metadata, Vocal Details, and Arrangement. The skill preserves musical instructions attached to lyric section tags in the arrangement description while keeping the lyric text in the lyrics input. See the skills page for installation instructions and a full feature overview.

npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter

Demo

Explore music generation examples on the MiniMax Music 3 Demo.

MiniMax Music 3 architecture diagram

Complete Songs with Long-Range Coherence

MiniMax Music 3 natively supports full-song generation up to five minutes. The model maintains musical themes, rhythm, vocal identity, and arrangement progression across long sequences, enabling complete structures such as intro, verse, pre-chorus, chorus, bridge, instrumental break, and outro.

Fine-Grained Music Control

The model accepts two complementary inputs:

For precise control, we recommend using a Structured Caption with three sections:

This representation allows the model to follow not only a global style, but also the musical development of the song over time.

Hybrid-LM

MiniMax Music 3 uses a hierarchical autoregressive architecture that separates global musical modeling from local acoustic modeling.

The Global LLM is initialized from Qwen3-8B. During training, its embedding and output layers are first adapted to semantic music tokens. The Global and Local LLMs are then jointly trained to model all RVQ codebooks.

Continuous Hidden-State Synthesis

Instead of decoding only from discrete RVQ tokens, the synthesis module fuses the final hidden states of the Global and Local LLMs. These continuous representations preserve richer acoustic information for vocal articulation, instrumental texture, and temporal continuity.

The synthesis path is:

Global and Local LLM hidden states
                ↓
       Hidden-state fusion
                ↓
     Flow Matching (2.4B)
                ↓
        Flow-VAE latent
                ↓
    Flow-VAE Decoder (123M)
                ↓
       32 kHz stereo audio

The Flow-VAE architecture is adapted from MiniMax Speech and retrained for the dynamic range and spectral characteristics of music.

Music Tokenizer

The training tokenizer uses eight layers of Residual Vector Quantization (RVQ):

Training first optimizes the semantic codebook, then jointly trains all eight codebooks. At inference time, waveform synthesis uses the fused LLM hidden states and does not require the discrete tokenizer decoder.

How to Use

Download the Model

hf download MiniMaxAI/MiniMax-Music3 --local-dir /path/to/minimax_ttm

Serve with SGLang-Omni

MiniMax Music 3 is currently supported by SGLang-Omni. From the SGLang-Omni repository root, run:

sgl-omni serve --model-path MiniMaxAI/MiniMax-Music3 --port 8000

Inference uses two CUDA GPUs:

Generate Music

The service uses the shared speech API. Put the lyrics in input and the music description in instructions.

curl http://127.0.0.1:8000/v1/audio/speech \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "minimax_ttm",
    "input": "[Verse]\nMorning light filtering through the pine\n[Chorus]\nSoftly the world begins to breathe",
    "instructions": "A warm acoustic pop song with intimate female vocals, fingerpicked guitar, soft piano, and a gradual emotional build into a wide final chorus.",
    "response_format": "wav",
    "seed": 7,
    "max_new_tokens": 9000,
    "stream": false
  }' \
  --output minimax_music3.wav

An example generated with this checkpoint is available at assets/minimax_ttm.wav.

Music Caption Rewriter Skill

This repository includes music-caption-rewriter, an agent skill that turns a brief music description and optional tagged lyrics into a detailed Music 3.0 Structured Caption. It uses a bundled text library to select compatible style references, combine requested influences, and build a coherent section-by-section arrangement without external APIs or runtime dependencies.

Then invoke $music-caption-rewriter in a supported coding agent with a music description and, optionally, lyrics containing section tags such as [Verse] or [Chorus]. The skill returns Global Metadata, Vocal Details, and Arrangement while preserving explicit musical constraints and keeping lyric text out of the rewritten caption.

Limitations

Contact Us

Contact us at [email protected].

MiniMax-Music3 (MiniMax-AI/MiniMax-Music3)

Searching Database…

这是什么?MiniMax Music 3 是一个音乐生成模型,可以根据歌词和音乐描述创作最长五分钟的完整歌曲,生成 32 kHz 16 位立体声 WAV 音频,结构连贯、人声富有表现力。
这是开箱即用的应用,还是只是原始模型?它是原始的模型检查点,不是托管应用——你需要自己下载权重,并通过受支持的推理服务器来运行。
实际怎么用它生成一首歌?下载模型,从 SGLang-Omni 仓库根目录启动服务,然后调用共享的语音 API,把歌词放进 input 字段,把音乐描述放进 instructions 字段。
除了权重之外,运行推理还需要什么?你需要 SGLang-Omni 服务栈,因为它是目前唯一受支持的运行该模型的方式。
有哪些我需要知道的主要限制?生成不支持流式输出,文本提示词上限为 5,000 个 token,音频输出限制在 9,000 个声学帧以内,而且请求的节拍、调性、配器或结构不一定总是被严格遵守。
推理需要几块 GPU?各自负责什么?需要两块 CUDA GPU:一块负责基于 Qwen3 的八码本 RVQ 自回归生成,另一块运行 Flow Matching 和波形解码。
music-caption-rewriter 技能是做什么的?它是一个内置的代理技能,可以把简短描述和可选的带标签歌词转换为详细的 Music 3.0 结构化字幕(包含 Global Metadata、Vocal Details 和 Arrangement),使用内部文本库,不调用外部 API。
怎么控制歌曲的结构,比如主歌和副歌?歌词可以包含 [Intro]、[Verse]、[Pre-Chorus]、[Chorus]、[Bridge]、[Instrumental]、[Outro] 等段落标签,而音乐描述则单独控制这些段落的风格、配器和编排。
模型如何让五分钟的歌曲保持连贯?它采用分层的 Hybrid-LM:一个 8B 的 Global LLM(从 Qwen3-8B 初始化)建模长程音乐结构,一个 0.6B 的 Local LLM 补充帧级声学细节,两者共同输入 Flow Matching/Flow-VAE 合成模块生成最终音频。
Creator
MiniMax-AI
Size
36.1 MB
Stars
966
Updated
CommitAug 14
Age
2mo
Commits · 90 Days