MiniMax

MiniMax Music 3

minimax-music-3

Basta inserir a letra e a descrição musical para gerar uma música estéreo de até cerca de 5 minutos, com vocais e estrutura musical completa, ideal para produzir rapidamente demos de músicas e trilhas sonoras personalizadas

minimax-music-3

Experimentar minimax-music-3

Entrada

Lyrics

Criações

Ver todas as criações

Saída

audio

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Engenharia de prompts do MiniMax Music 3: exemplos de descrição musical estruturada

Estilo Engenharia de Prompt · song-demo · Arranjo

Prompt

Indie pop de andamento médio, 104 BPM, tonalidade de Lá maior, quente e levemente nostálgico. Vocal principal feminino; o verso intimista sob microfone de campo próximo se expande gradualmente para um refrão brilhante com overdubs, e a parte do hook é acompanhada por harmonias de fundo suaves. Instrumentação: violão elétrico fingerstyle, piano Rhodes suave, baixo de sintetizador encorpado, bateria tocada com escovinhas, avançando gradualmente no pré-refrão. Arranjo: a introdução esparsa começa com violão e pads; o verso se contém em violão e voz; o pré-refrão adiciona bateria e baixo; o refrão é a banda completa com harmonias; a ponte desce para o piano; o refrão final usa vozes em várias camadas; e o desfecho desaparece gradualmente ao som do violão. O arco emocional vai da contemplação silenciosa à afirmação serena.

Lyrics:
[intro]

[verse]
Morning light across the desk
Notes I never sent
Every line a little test
Of what I really meant

[pre-chorus]
And the page begins to turn
Slowly, slowly

[chorus]
Write it down, write it out
Every word I kept in doubt
Let the structure hold the sound
Write it down, write it out

[verse]
Signals settle into place
Order out of noise
Rhythm finds an open space
And gives the thought a voice

[pre-chorus]
And the shape begins to form
Clearly, clearly

[chorus]
Write it down, write it out
Every word I kept in doubt
Let the structure hold the sound
Write it down, write it out

[bridge]
If the framework holds the frame
The melody can move

[instrumental]

[chorus]
Write it down, write it out
Every word I kept in doubt
Let the structure hold the sound
Write it down, write it out

[outro]
Slowly fading, structured sound

Copie o prompt completo e adapte-o para a sua própria geração.

Etiquetas

Panorama completo dos parâmetros do MiniMax Music 3: entenda o controle condicional de text-to-music com uma única música

Estilo Texto para Música · Criação de músicas · Arranjo

Prompt

Hino de pop rock, 124 BPM, tonalidade de Mi maior, brilhante e cheio de impulso. Vocal masculino principal, timbre levemente rouco na região média, com backing vocal de harmonias coletivas em várias camadas no refrão. Instrumentação: arpejos de guitarra elétrica limpa, nítidos e brilhantes; power chords com distorção e palm mute; linha de baixo melódica; bateria que começa acústica e depois se torna eletrônica; pandeiro delicado e palmas. Arranjo: a introdução é composta por um único arpejo de guitarra limpa e timbres suaves de base; o verso mantém apenas baixo e guitarra com abafamento; o pré-refrão adiciona viradas ascendentes de bateria e crescendo de cordas; o refrão abre a banda completa, com guitarra ampla em estereofonia e vocais em camadas; a ponte desce para piano e vocal sustentado, seguida pelo refrão final com modulação ascendente, e o desfecho desaparece gradualmente sobre o motivo do arpejo. A progressão emocional vai da contenção serena à euforia expansiva.

Lyrics:
[intro]
Streetlights hum on an empty street

[verse]
I kept the map folded in my coat
Every road looked the same from here
Counting cracks in the pavement stone
Waiting for the signal to appear

[pre-chorus]
And the air goes thin before the sound
One more breath and then we're off the ground

[chorus]
We run into the open
Where the skyline breaks in two
We run into the open
Every mile a lighter hue
Let the whole night know our name
We run into the open flame

[verse]
Half the town is asleep behind the glass
I can hear my own heart in the wire
All the quiet years are moving fast
Every step is setting them on fire

[pre-chorus]
And the air goes thin before the sound
One more breath and then we're off the ground

[chorus]
We run into the open
Where the skyline breaks in two
We run into the open
Every mile a lighter hue
Let the whole night know our name
We run into the open flame

[bridge]
Hold the line, hold the light
Nothing left to hold tonight
Hold the line, hold the light

[chorus]
We run into the open
Where the skyline breaks in two
We run into the open
Every mile a lighter hue
Let the whole night know our name
We run into the open flame

[outro]
Streetlights hum on an empty street

Copie o prompt completo e adapte-o para a sua própria geração.

Etiquetas

Preços

minimax-music-3 per second

Preço unitário	$0.0026

Visão geral do posicionamento

minimax-music-3 é um modelo de geração de música a partir de texto lançado pela MiniMax, chamado por meio da interface unificada do HiAPI.ai. Ao inserir a letra e a descrição musical, é possível gerar uma canção completa com vocais e arranjo completo, com suporte a estruturas de seções como introdução, verso, refrão, ponte e coda, com duração única controlável em poucos minutos. É adequado para desenvolvedores e equipes de conteúdo que precisam produzir demos de canções em lote, personalizar música de fundo ou converter letras existentes em áudio.

Destaques principais

Controle de entrada dupla com letra e descrição — a letra marca as etiquetas de seção linha a linha, e o texto de descrição pode especificar gênero, BPM, tonalidade e estilo vocal; estrutura e estilo são controlados separadamente.
Forma musical completa, não fragmentos musicais — o resultado gerado inclui um arranjo sistemático de seções da introdução à coda, com vocais, podendo ser usado diretamente como protótipo de uma canção finalizada.
Arquitetura em camadas conciliando estrutura e detalhes vocais — a camada global responde pelo avanço da forma musical de longo alcance, enquanto a camada local trata detalhes acústicos em nível de quadro, tornando a transição entre seções de áudio longo mais estável.
Duração com limite superior configurável em segundos — o parâmetro duration aceita de 1 a 300 segundos, e o modelo pode encerrar antecipadamente, facilitando controlar a saída conforme a duração do material.

Descrição das capacidades

Geração de forma musical estruturada: organiza automaticamente introdução, verso, pré-refrão, refrão, ponte, trecho instrumental e coda; basta escrever etiquetas por linha na letra para especificar a qual seção pertencem, e linhas sem etiqueta são descartadas, sendo necessário organizar previamente o formato da letra.

Controle condicional de atributos musicais: o prompt pode descrever gênero, BPM, tonalidade, evolução emocional, instrumentação e detalhes vocais; quanto mais específica a descrição, mais preciso o controle de estilo, adequado para criação em lote que exige posicionamento de estilo estável.

Definição de limite superior de duração: duration define em segundos o limite máximo de comprimento gerado, com padrão de 60 segundos e faixa de 1 a 300 segundos; o modelo pode terminar antecipadamente, facilitando ajustar a saída ao comprimento de vídeos ou trechos de podcast.

Geração reproduzível: oferece o parâmetro seed; a mesma entrada com uma semente fixa reproduz o mesmo resultado; se omitido, usa-se uma semente aleatória, adequado para comparar descrições diferentes ou fazer gestão de versões.

Especificação fixa de saída de áudio: a saída é WAV estéreo de 32 kHz e 16 bits, podendo entrar diretamente no fluxo de edição ou mixagem, sem necessidade de transcodificação adicional.

Cenários de aplicação

Produção rápida de demos de canções por músicos — insira a letra completa e a descrição de estilo para obter um protótipo de canção finalizada com vocais e arranjo, usado para apresentar a direção à equipe ou ao cliente.
Trilha personalizada para equipes de vídeo e jogos — gere música de fundo conforme BPM e descrição de emoção, defina a duração para corresponder ao comprimento do vídeo e insira diretamente na edição ou na trilha de áudio do jogo.
Conversão de letras existentes em canções — organize a letra já escrita com etiquetas de seção e insira-a, junto com a descrição de estilo, para convertê-la em uma versão cantada auditionável.
Exploração em lote por gênero e emoção — use uma seed fixa e vários conjuntos de descrições para comparar resultados de gêneros e tonalidades diferentes e selecionar rapidamente materiais utilizáveis.

Limitações e recomendações de seleção

A fidelidade a estilos musicais não ocidentais é limitada, e prompts com forte estilização podem se desviar do esperado; o cartão do modelo não declara capacidade de canto multilíngue, e letras que não sejam em inglês precisam ser validadas primeiro com amostras curtas. O limite por geração é de cerca de 5 minutos, e a saída é fixa em WAV estéreo de 32 kHz e 16 bits, sem outras opções de taxa de amostragem ou codificação. Caso seja necessário uma obra completa mais longa ou canto multilíngue rigoroso, valide primeiro o efeito em trechos curtos antes de decidir pela adoção.

Novidades

Ver o changelog →

Novo modelo Novo modelo: minimax-music-3 — geração de músicas de alta fidelidade da MiniMax, com duração controlável. Letra obrigatória… Aug 17, 2026

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: minimax-music-3

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para minimax-music-3 e a rota default — veja a tabela de parâmetros abaixo.

seedintegerOpcional

Semente aleatória para reproduzir o resultado; use um número inteiro; se omitida, uma semente aleatória será usada.

lyricsstringObrigatório

Texto da letra a ser cantada; as tags estruturais como [intro], [verse], [chorus] etc. devem ocupar cada uma sua própria linha; o texto na mesma linha de uma tag será descartado.

promptstringObrigatório

Descrição musical, usada para especificar estilo, clima, vocal, instrumentação e arranjo; quando for necessário controle preciso, pode incluir gênero, BPM, tonalidade, progressão de clima, detalhes vocais e arranjo seção por seção.

durationnumberOpcionalPadrão: 60min 1max 300

Duração máxima do áudio gerado, em segundos; o modelo pode terminar antes. Padrão: 60 segundos.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-music-3",
  "input": {
    "lyrics": "…",
    "prompt": "…",
    "duration": 60
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-music-3",
    input: {
      "lyrics": "…",
      "prompt": "…",
      "duration": 60
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-music-3",
        "input": {
          "lyrics": "…",
          "prompt": "…",
          "duration": 60
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}