# MiniMax-Music3 (modelo de música)

> MiniMax-Music3: músicas completas com vocais cantados a partir de um prompt de estilo e uma letra com tags \[verse\]/\[chorus\], até 5 minutos, estéreo 44.1 kHz, para temas de abertura e singles de trilha sonora. Roda localmente na sua GPU com audio.cpp. Licença comunitária: exiba "MiniMax-Music3", marque a saída como gerada por máquina, teto de receita.

- Id: `aigd.audio-minimax-music3`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.2 (publicado em 2026-11-22)
- Licença: SEE LICENSE IN README.md
- Requer o app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.audio-minimax-music3

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.audio-minimax-music3
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.audio-minimax-music3` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

````markdown
# MiniMax-Music3 (`aigd.audio-minimax-music3`)

MiniMax-Music3 é um modelo de geração de músicas da MiniMax. Ele escreve músicas completas com letras cantadas a partir de um prompt de estilo (gênero, andamento, tonalidade, vocais, arranjo) e da sua letra com tags `[verse]` / `[chorus]`: até 5 minutos de estéreo 44.1 kHz. No app AI Game Dev ele roda localmente na sua GPU por meio de **Local audio generation** (`aigd.audiocpp`, o runtime audio.cpp), então cada música não custa nada. Ele serve para desenvolvedores de jogos que precisam de músicas com vocais e letras estruturadas, como temas de abertura e singles de trilha sonora. Sua licença comunitária permite uso comercial com condições (veja a seção de licença abaixo).

## O que você pode criar

- Músicas-tema com vocais para uma tela de título, trailer ou créditos.
- Músicas com versos e refrões a partir de letras que você escreveu para um personagem ou um momento da história.
- Música diegética: canções para um rádio dentro do jogo, um bardo de taverna ou uma cena de show.

A letra é obrigatória, então este modelo não é a escolha certa para instrumentais. Para música instrumental, use [ACE-Step 1.5](https://ai-game.dev/packages/aigd.audio-ace-step-1-5), [Magenta RealTime 2](https://ai-game.dev/packages/aigd.audio-magenta-rt2) ou [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music).

## Exemplos de pedidos

- "Escreva um hino de rock heroico de 2 minutos com vocais masculinos para o trailer, usando esta letra: [verse] ... [chorus] ..."
- "Faça uma canção folk lenta em ré menor para o bardo da taverna, com esta letra: ..."
- "Gere uma música synth-pop animada com uma cantora para os créditos finais, com cerca de 3 minutos, usando esta letra: [verse] ... [chorus] ..."

## Destaques

| Especificação | Valor |
|---|---|
| Saída | WAV estéreo 44.1 kHz, salvo no seu projeto |
| Duração | 10 s a 5 min (padrão 60 s) |
| Entrada | prompt de estilo (até 1,000 caracteres) e letra (obrigatória, até 4,000 caracteres) com tags `[verse]` / `[chorus]` |
| Passos | padrão 30, até 60 |
| Orientação | 0.5 a 5 (padrão 1.7) |
| Semente | padrão 0 |

`durationSeconds` é um limite: a música pode terminar antes quando a letra acaba.

Este pacote é apenas dados. Ele indica os arquivos do modelo. O app baixa os arquivos depois que você confirma, verifica cada um por sha256 e os executa com audio.cpp no seu computador.

## Download

8.45 GB, 13 arquivos, fixados no commit `46fe77f8` do Hugging Face de [`audio-cpp/MiniMax-Music3-GGUF`](https://huggingface.co/audio-cpp/MiniMax-Music3-GGUF/tree/46fe77f8bb395ccdbe797d784225f7b84866e7ce) (mix padrão de componentes do audio.cpp):

| Arquivo | Parte | Tamanho |
|---|---|---:|
| `language_model_q4_0.gguf` | modelo de linguagem de música 8B, Q4_0 | 6.01 GB |
| `transformer_q4_0.gguf` | transformer de flow matching, Q4_0 | 1.40 GB |
| `rvq_depth_decoder_q8_0.gguf` | decodificador de profundidade RVQ, Q8_0 | 0.71 GB |
| `vocoder.gguf`, `condition_encoder.gguf` | vocoder e codificador de condicionamento | 0.32 GB |
| `tokenizer/*`, `config.json`, `config/*.json` | tokenizer e configuração | 11 MB |

Por que não o `ggml-org/MiniMax-Music3-GGUF` oficial (llama.cpp, 2026-11-17)? Ele tem apenas arquivos Q8_0 e BF16 (15.8 GB para Q8 com seu projetor) e roda em um segundo runtime (o `llama-tts` do llama.cpp). O pacote audio.cpp precisa de cerca de 10 GB de memória de GPU e compartilha o runtime com os outros modelos de áudio.

## Quais computadores

| Computador | Requisitos | Velocidade |
|---|---|---|
| GPU NVIDIA (CUDA) ou outra GPU (Vulkan) | cerca de 12 GB de memória de GPU | cerca de 1.35× o tempo real em uma RTX 5090 (upstream: pico de 9.8 GiB para uma música de 30 s) |
| Mac com Apple silicon (Metal) | cerca de 24 GB de memória (estimativa) | ainda não medido |

Músicas mais longas precisam de mais memória: o runtime reserva espaço para a música inteira. Medido pelo publicador do GGUF em uma RTX 5090 (30 s, 30 passos de flow); ainda não medido por nós.

## Licença

**MiniMax-Music3 Community License** ([texto na revisão fixada](https://huggingface.co/MiniMaxAI/MiniMax-Music3/blob/1b525ccb685ae809f33027c51c351eeb5833cf72/LICENSE)). Gratuita, inclusive para uso comercial, com condições:

- **Atribuição na interface.** Um produto ou serviço comercial que usa o modelo deve exibir com destaque "MiniMax-Music3" na sua interface de usuário (§3.1). O AI Game Dev mostra o modelo com esse nome exato onde quer que você o selecione ou veja seus resultados.
- **Teto de receita.** Acima de US$20 milhões de receita anual (sua e de suas afiliadas) proveniente de produtos ou serviços que usam o modelo, você precisa de autorização prévia por escrito da MiniMax (api@minimax.io, assunto "MiniMax-Music3 licensing - authorization request") (§3.2).
- **Uso aceitável.** O Anexo A da licença lista 19 usos proibidos (entre eles uso militar e violação de direitos de terceiros); a MiniMax pode atualizá-lo.
- **Divulgue o conteúdo de IA.** A música que você publicar deve ser marcada de forma clara e destacada como gerada por máquina (Anexo A, item 11).
- **Salvaguardas e indenização.** Quem permite que terceiros gerem com o modelo deve manter salvaguardas razoáveis contra usos que violem direitos (§4), e você indeniza a MiniMax por violações.
- Mantenha o aviso de direitos autorais e de licença com cada cópia dos pesos.

Componentes citados pela licença: o modelo de linguagem foi ajustado a partir do [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) (Apache-2.0); o DiT foi modificado a partir das ferramentas do Stable Audio (MIT); o VAE, do DAC (MIT). Conversão para GGUF: [`audio-cpp/MiniMax-Music3-GGUF`](https://huggingface.co/audio-cpp/MiniMax-Music3-GGUF) (uma conversão da comunidade; seu card declara a licença MiniMax-Music3 e traz o mesmo arquivo LICENSE).

Todos os arquivos são baixados do Hugging Face. O AI Game Dev não os hospeda.
````
