Pular para o conteúdo

API do Mage · Modelo de áudio

API do MiniMax Music 3

Músicas completas a partir da sua letra, com pesos abertos

POST https://api.mage.space/v1/minimax_music/generate

Resumo rápido

A API do MiniMax Music 3 executa o MiniMax Music 3 pelo Mage em POST https://api.mage.space/v1/minimax_music/generate. Uma solicitação com as configurações padrão custa 125 Gems (cerca de US$ 0,125), sem assinatura. O MiniMax Music 3 não aceita menções com @handle.

  • ÁudioSaída
  • 1Variante
  • 125Gems por clipe, padrão
  • $0.125Aproximadamente, em USD

Visão geral

O que a API do MiniMax Music 3 faz

O modelo de músicas aberto da MiniMax: músicas completas de até 5 minutos, com vocais que cantam a sua letra, ou instrumentais, moldadas por uma descrição do gênero, da voz e do arranjo. Com LoRAs.

O modelo de músicas de pesos abertos da MiniMax: músicas completas com vocais cantados que seguem a sua letra, ou instrumentais, de até 5 minutos, em MP3 estéreo de 44,1 kHz, com LoRAs. Coloque as palavras em `lyrics` e o som no prompt.

Ele gera apenas a partir do prompt.

Início rápido

Chame a API do MiniMax Music 3

Defina MAGE_API_KEY, envie para /minimax_music/generate e consulte status_url até a solicitação ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
  "duration": "120",
  "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
  "model_id": "minimax-music-3"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_music', {
  prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
  duration: '120',
  lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe',
  model_id: 'minimax-music-3',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_music", {
    "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
    "duration": "120",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
    "model_id": "minimax-music-3",
})

print(request["result"]["url"])

Modelos

Valores de model_id do MiniMax Music 3

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
minimax-music-3MiniMax Music 3Sim

Opções

Parâmetros do MiniMax Music 3

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
duration30, 60, 120, 180, 240, 300

Regras

O que a API do MiniMax Music 3 exige

  • O prompt descreve a música, com no máximo 4000 caracteres: gênero, andamento e tom, clima e como ela evolui, o vocalista (indique a voz, ou a música pode sair instrumental) e os instrumentos.
  • `lyrics` contém a letra a ser cantada, com no máximo 6000 caracteres. Coloque cada tag de seção ([intro], [verse], [pre-chorus], [chorus], [bridge], [outro]) em uma linha própria: palavras na mesma linha da tag são descartadas.
  • Deixe `lyrics` vazio, ou defina `instrumental` como true, para obter uma música instrumental.
  • `duration` é o tempo máximo que a música pode ter, e define o preço; o modelo encerra a música quando a letra e o arranjo terminam, muitas vezes antes.

Mais modelos de áudio

Outras APIs de geração de áudio no Mage

  • Áudio · a partir de 19 Gems

    API do Seed Audio

    Vozes, música e efeitos sonoros a partir de um único prompt

  • Áudio · a partir de 113 Gems

    API do Eleven Music

    Músicas da ElevenLabs, com ou sem vocais

  • Áudio · a partir de 30 Gems

    API Eleven Speech

    ElevenLabs v4: fala realista que você pode dirigir

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do MiniMax Music 3?
Uma solicitação do MiniMax Music 3 com as configurações padrão (MiniMax Music 3) custa 125 Gems, cerca de US$ 0,125. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do MiniMax Music 3?
POST https://api.mage.space/v1/minimax_music/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos MiniMax Music 3 posso chamar?
minimax-music-3 (MiniMax Music 3). O padrão é o MiniMax Music 3.
O MiniMax Music 3 aceita imagens de referência ou personagens?
O MiniMax Music 3 não aceita entradas de imagem, vídeo ou áudio. O MiniMax Music 3 não aceita menções com @handle.
Posso usar o MiniMax Music 3 no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o MiniMax Music 3 pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do MiniMax Music 3 ficam guardados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

CharactersComunidade