Introdução
O MiniMax Music 3.0 no SpicyAPI é uma tarefa de texto para música que devolve uma música completa por requisição: voz principal, arranjo de base e mixagem final em um único MP3 estéreo. Você envia uma descrição de estilo em prompt e, se tiver, as palavras a cantar em lyrics; o modelo cuida da melodia, do arranjo e da interpretação. Nos nossos testes, as músicas ficaram entre 1:09 e 3:58, e toda música custa o mesmo preço fixo.
Recursos e destaques
Uma música inteira, não um loop
O resultado é uma música estruturada, com introdução, versos, um refrão que volta e um final, e não um trecho curto que se repete. O próprio modelo define a duração, sobretudo pela quantidade de letra que você envia, e mixa voz e base em um único arquivo estéreo pronto para tocar.
Três formas de lidar com a letra
Você pode cantar a sua própria letra, pedir que o modelo a escreva ou dispensar o cantor. A letra que você enviar é interpretada como escrita, e tags de seção como [Verse] e [Chorus] orientam o arranjo. Com lyrics vazio, generate_lyrics (ativado por padrão) escreve uma letra completa a partir do prompt. Com instrumental ativado, a faixa não tem voz alguma.
Preço fixo, qualidade de arquivo ajustável
Duração, bitrate e sample_rate não alteram o custo de uma música. Escolha 256 kbps a 44,1 kHz para um master, ou um bitrate menor para arquivos de prévia mais leves.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | A descrição de estilo, com até 2.000 caracteres: gênero, clima, andamento, instrumentos, o tipo de voz, o cenário. pelo menos 1 caracteres · no máximo 2000 caracteres |
lyrics | Não | As palavras a cantar, com até 3.000 caracteres. Coloque cada verso em sua própria linha e deixe uma linha vazia para uma pausa. pelo menos 1 caracteres · no máximo 3000 caracteres |
generate_lyrics | Não | Ativado por padrão: quando lyrics está vazio, o modelo escreve a letra a partir do seu prompt. A letra que você enviar não é alterada. Valor padrão: |
instrumental | Não | Ative para uma música sem voz; nenhuma letra é necessária. Desativado por padrão. Valor padrão: |
bitrate | Não | Bitrate do MP3 em bits por segundo: 32000, 64000, 128000 ou 256000 (padrão). Valores menores geram arquivos menores. |
sample_rate | Não | Taxa de amostragem em Hz: 16000, 24000, 32000 ou 44100 (padrão). Não altera o preço. |
Preços
$0.18 / música
Um preço fixo por música, qualquer que seja a duração ou a qualidade do áudio.
Casos de uso
Músicas construídas em torno da sua própria letra
Escreva primeiro a letra, marque as seções e descreva o gênero e a voz que você imagina. Serve para músicas personalizadas, temas de personagens para histórias e jogos, paródias e demos rápidas de letra que você quer ouvir cantada antes de seguir adiante.
Música para vídeos e lives
Ative instrumental para trilhas de fundo, bases lounge e músicas de abertura, ou mantenha a voz para uma música-tema. Uma faixa de um a quatro minutos cobre a maioria dos vídeos curtos em uma única requisição, e o preço fixo torna barato gerar algumas versões e ficar com a melhor.
Guia de prompt e dicas práticas
Mantenha o estilo e as palavras separados
Use prompt só para o som: gênero, andamento em bpm, dois ou três instrumentos, o tipo de voz e o clima, por exemplo “dreamy synth-pop, 100 bpm, airy female lead vocal, shimmering pads, late-night city mood”. Coloque em lyrics tudo o que deve ser cantado. Palavras de estilo deixadas na letra tendem a ser cantadas.
Molde a música com tags de seção
Escreva um verso por linha e coloque tags como [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] e [Outro] em linhas próprias. Repita o texto do refrão onde quiser que ele volte. Um verso e um refrão rendem uma música de cerca de um minuto e meio; acrescente versos e uma ponte para uma mais longa.
Saiba o que o filtro barra
A MiniMax verifica prompts e letras. Linguagem forte é cantada como escrita, mas letras além disso são recusadas e não são cobradas; mantenha essas linhas suaves.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/music-3.0/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"bitrate": 256000,
"sample_rate": 44100
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
