README.md

metadata

title: MiniMax-Music3-Jam
emoji: 🎤
colorFrom: pink
colorTo: red
sdk: gradio
sdk_version: 6.24.0
app_file: app.py
pinned: false
license: mit
short_description: Describe any song, MiniMax Music 3 writes & sings it
startup_duration_timeout: 1h
suggested_hardware: zero-a10g
models:
  - MiniMaxAI/MiniMax-Music3
  - Tongyi-MAI/Z-Image-Turbo

MiniMax-Music3-Jam

Describe any song in plain English. An LLM writes the title, the tagged lyrics and the three-part structured caption (Global Metadata / Vocal Details / Arrangement) from the official prompting guide, then MiniMax Music 3 generates the full song with vocals. Songs can be shared to a community feed (stored in the victor/minimax-music3-community bucket, each with its creation date).

How it works

• Compose (CPU): composer.py calls an LLM on the HF Inference Router and returns {title, tags, lyrics, global_metadata, vocal_details, arrangement}.
• Sing (ZeroGPU): engine.py is the diffusers ModularPipeline port of MiniMax Music 3 with the AoTI kernels from diffusers-internal-dev/MiniMax-Music3-aoti (same path as the official Space). Cover art comes from Z-Image-Turbo in the same GPU allocation.
• Share: WAV + cover + meta.json are written to the bucket mounted at /data; the feed is served from memory.

API

• POST /create(description, audio_duration, seed, community, instrumental) streams status JSON then the final result {audio, title, tags, lyrics, caption, seed, duration, created_at, thumbnail?, community_url?}.
• POST /generate(caption, lyrics, audio_duration, seed, title, tags, community) for explicit inputs.
• POST /community() returns the newest shared songs.

Requires the HF_TOKEN secret (composer LLM) and the bucket volume hf://buckets/victor/minimax-music3-community:/data.