Geração de Música

Habilidade de Geração de Música

Visão Geral

Esta habilidade gera músicas (vocais ou instrumentais) a partir de uma especificação JSON utilizando a API de geração musical do MiniMax (/v1/music_generation). Você descreve o estilo/mood/cena no prompt, opcionalmente fornece letras (lyrics), e o script retorna um MP3.

Fluxo de Trabalho

Passo 1: Entender os Requisitos

Identifique o estilo, mood, cena, idioma desejados e se o usuário quer vocais ou uma faixa puramente instrumental. Decida se deve fornecer letras ou deixar o modelo escrevê-las.

Passo 2: Criar a Especificação JSON

Escreva um arquivo JSON em /mnt/user-data/workspace/ nomeado como {nome-descritivo}.json:

{
  "title": "Café da Noite Chuvosa",
  "prompt": "folk indie, melancólico, introspectivo, caminhando sozinho, café",
  "lyrics": "[verso]\nOs postes brilham o vento noturno suspira\n[refrão]\nEmpurre a porta de madeira ar quente lá dentro"
}

Campos:

• title (opcional): um nome legível.
• prompt (obrigatório): estilo, mood e cena. Direciona o caráter musical.
• lyrics (opcional): letras da música. Use \n entre linhas e tags de estrutura como [Intro], [Verso], [Pré-Refrão], [Refrão], [Ponte], [Outro].
• is_instrumental (opcional, booleano): defina true para uma faixa puramente instrumental (sem necessidade de letras).

Comportamento:

• lyrics fornecido → essas letras são cantadas.
• is_instrumental: true → instrumental, sem vocais.
• nenhum dos dois → o modelo escreve letras automaticamente a partir do prompt (lyrics_optimizer).

Passo 3: Executar a Geração

python /mnt/skills/public/music-generation/scripts/generate.py \
  --prompt-file /mnt/user-data/workspace/noite-chuvosa-cafe.json \
  --output-file /mnt/user-data/outputs/noite-chuvosa-cafe.mp3

Parâmetros:

• --prompt-file: Caminho absoluto para a especificação JSON (obrigatório).
• --output-file: Caminho absoluto para o MP3 de saída (obrigatório).

[!NOTA] NÃO leia o arquivo Python, apenas chame-o com os parâmetros.

Ambiente

• MINIMAX_API_KEY (obrigatório): sua chave de interface MiniMax.
• MINIMAX_API_HOST (opcional): padrão https://api.minimaxi.com.
• MINIMAX_MUSIC_MODEL (opcional): padrão music-2.6-free (funciona para todos os usuários com chave de API); usuários do Plano Pago/Token podem definir music-2.6 para limites mais altos.

Manipulação da Saída

• A música é salva como MP3 (tipicamente em /mnt/user-data/outputs/).
• Compartilhe o arquivo gerado com o usuário usando a ferramenta present_files.
• Ofereça-se para iterar no estilo ou nas letras se ajustes forem necessários.

Notas

• Mantenha o prompt focado em estilo/mood/cena; coloque as palavras cantadas reais em lyrics.
• Para músicas em outros idiomas, escreva lyrics no idioma alvo.