MiniMax Music 2.5 por trás de uma única chamada REST
A MiniMax Music API expõe o MiniMax Music 2.5 pela mesma conta, chave de API e modelo de tarefa assíncrona do resto da plataforma. Envie um prompt descrevendo a faixa desejada junto com a letra — obrigatória para o MiniMax Music 2.5, de 10 a 3000 caracteres — e o endpoint retorna um task_id imediatamente.
Os resultados chegam pelo endpoint de feed dedicado ao MiniMax. Consulte GET /v2/minimax/feed?workId=... com seu task_id até o status SUCCESS ou FAILED, ou informe callback_url e deixe a plataforma enviar o resultado final ao seu webhook. Uma tarefa concluída retorna a URL do áudio gerado no campo response.
Quickstart: gere e consulte o feed
Faça POST em /v2/minimax/generate, guarde o task_id retornado e consulte o feed do MiniMax até a música ficar pronta.
curl -X POST "https://udioapi.pro/api/v2/minimax/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Cinematic orchestral pop, emotional female vocal, warm piano",
"lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow"
}'
curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=YOUR_TASK_ID"Consulte a cada 5–10 segundos com tempo limite definido. Os parâmetros opcionais bitrate e sample_rate controlam a codificação do áudio.
Parâmetros da requisição do MiniMax Music 2.5
O endpoint de geração aceita um conjunto compacto de parâmetros. Uma requisição custa 30 créditos — cerca de $0.30 com 1 USD = 100 créditos.
| Parâmetro | Tipo | Obrigatório | Observações |
|---|---|---|---|
| prompt | string | obrigatório | Descreve a faixa — gênero, clima, instrumentação |
| lyrics | string | obrigatório | 10–3000 caracteres; obrigatória para o MiniMax Music 2.5 |
| bitrate | number | opcional | Taxa de bits do áudio, ex. 256000 |
| sample_rate | number | opcional | Taxa de amostragem do áudio, ex. 44100 |
| callback_url | string | opcional | Webhook HTTPS público para o resultado final |
| public | boolean | opcional | Se a tarefa pode ser pública |
A resposta retorna data.task_id e status IN_PROGRESS. Consulte /v2/minimax/feed?workId=<task_id> até o status SUCCESS (URLs de áudio em response) ou FAILED.
O que você pode criar
As tarefas MiniMax convivem com o restante da API de áudio.
Músicas com letra fiel
Forneça a letra completa — obrigatória, de 10 a 3000 caracteres — mais um prompt de estilo para conteúdo vocal determinístico.
Ler a documentaçãoFaixas vocais ou instrumentais
Oriente gênero, clima e arranjo pelo prompt enquanto o modelo cuida da composição.
Ler a documentaçãoMais motores, uma só chave
A mesma chave de API também chama a família chirp-v6 em /v2/generate quando você precisa de outro som.
Ler a documentaçãoEstender músicas geradas
Continue faixas compatíveis com o endpoint extend depois que a tarefa de origem concluir.
Ler a documentaçãoConversão para WAV
Converta o áudio gerado para WAV para entrega em fluxos de produção.
Ler a documentaçãoCallbacks e status
Consulte o feed do MiniMax ou entregue resultados à sua infraestrutura via callback_url.
Ler a documentaçãoComo funciona
Da chave de API a uma faixa tocável em quatro passos.
- 1
Crie uma chave de API
Entre na conta, abra o painel e copie uma chave. Guarde-a como segredo no servidor — nunca no código do navegador.
- 2
Envie prompt e letra
Faça POST em /v2/minimax/generate com prompt, lyrics e campos opcionais de codificação. Guarde o data.task_id.
- 3
Consulte o feed do MiniMax
Chame GET /v2/minimax/feed?workId=<task_id> a cada 5–10 segundos, ou defina callback_url para um webhook.
- 4
Baixe o áudio
Com status SUCCESS, o campo response contém a URL do áudio. Salve-a no seu próprio armazenamento.
Preço fixo por requisição
Cada requisição ao MiniMax Music 2.5 custa 30 créditos — cerca de $0.30 com 1 USD = 100 créditos. Não é preciso assinatura para usar a API; recarregue créditos pré-pagos quando precisar.
Os créditos nunca expiram. Requisições rejeitadas — por exemplo, letra ausente ou inválida — retornam 400 e não são cobradas como tarefa concluída.
Limites e observações
- A geração é assíncrona; o POST retorna um task_id, não o áudio.
- A letra é obrigatória para o MiniMax Music 2.5 e deve ter de 10 a 3000 caracteres.
- Consulte /v2/minimax/feed a cada 5–10 segundos com tempo limite definido, ou use callback_url.
- As URLs de áudio são temporárias — baixe os resultados para o seu próprio armazenamento.
- O MiniMax é um motor adicional; o endpoint padrão de geração de música continua sendo /v2/generate.
udioapi.pro é um serviço independente de terceiros. Não é afiliado, endossado nem operado pela Suno, Udio ou MiniMax.
Perguntas frequentes sobre a MiniMax Music API
Respostas sobre parâmetros, cobrança e o fluxo assíncrono.
Esta é a API oficial do MiniMax?
Não. udioapi.pro é um serviço de API independente de terceiros, com seus próprios endpoints, contas, créditos, termos e suporte. Não é afiliado, endossado nem operado pela MiniMax, Suno ou Udio.
Quanto custa uma requisição ao MiniMax Music 2.5?
Cada requisição a /v2/minimax/generate custa 30 créditos — cerca de $0.30 com 1 USD = 100 créditos.
A letra é obrigatória?
Sim. O MiniMax Music 2.5 exige o campo lyrics com 10 a 3000 caracteres. Requisições com letra ausente ou inválida são rejeitadas com resposta 400.
Como obtenho o resultado?
A resposta da geração retorna data.task_id. Consulte GET /v2/minimax/feed?workId=<task_id> a cada 5–10 segundos até SUCCESS, ou defina callback_url para receber um webhook. A URL do áudio então aparece no campo response.
Quais status vou ver?
As tarefas começam como IN_PROGRESS e terminam como SUCCESS ou FAILED. Uma tarefa com falha informa error_message no feed, e requisições rejeitadas não são cobradas como tarefas concluídas.
Existe um modelo mais barato para rascunhos?
Sim. A família chirp-v6 em /v2/generate inclui o chirp-v6-mini a 10 créditos por requisição — a camada rápida e econômica para prototipação.