Se o seu produto permite enviar músicas, os usuários podem testar diferentes arranjos e vocais com o mesmo áudio. O servidor guarda o ID, envia uma tarefa por proposta de remix, consulta o andamento e entrega as versões prontas ao player.
Integração
Campo | Descrição |
|---|---|
Endpoint |
|
Parâmetro do modelo |
|
Origem do áudio | Envie o áudio com purpose=remix para receber upload_audio_id ou use o song_id de uma música gerada no Mureka no último mês. |
Duração | 10–480 s |
Resultados por solicitação | n tem padrão 2 e máximo 3 |
Preço | Nova versão: $0.5 por faixa (a V8 continua a $0.2 por faixa). |
Documentação |
O resultado é uma nova interpretação da música original e não preserva o timbre de quem cantou a faixa. No momento, não é possível escolher o timbre de um cantor específico nem enviar outro áudio como referência de estilo.
Seleção do modelo: na solicitação, defina model como mureka-9.5 para usar o Remix V9.5 ou como mureka-8 para usar o V8.
Casos de uso
- Apps de covers e remixes: transforme uma gravação a capela em versões com arranjos completos em vários estilos.
- Vídeos curtos e plataformas de conteúdo: crie versões rock, eletrônica ou jazz da mesma trilha para acompanhar o clima de cada cena.
- Músicos e ferramentas de produção: expanda rapidamente uma demo cantada, tocada ou cantarolada para um arranjo completo e explore estilos.
- Trilhas de jogos e anúncios: crie variações de intensidade para o mesmo tema, conforme a cena, como na Demo B.
Fluxo de chamadas da API
Prepare o áudio original
O exemplo usa uma faixa com vocais. Chame POST /v1/files/upload com purpose definido como remix e salve o ID retornado. O V9.5 aceita MP3 e M4A de 10 a 480 segundos. Guarde a chave de API no servidor e use autenticação Bearer.
curl --fail-with-body https://api.mureka.ai/v1/files/upload \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-F "purpose=remix" \
-F "file=@./original.mp3"
Para uma música criada pela API de geração do Mureka, também é possível usar um song_id elegível. Use upload_audio_id para arquivos enviados ou song_id para músicas existentes. Envie apenas um por solicitação e consulte os limites de cada opção na referência.
Envie uma tarefa para uma proposta de remix
Envie o ID de upload e um prompt com o estilo desejado para POST /v1/song/remix. O exemplo especifica mureka-9.5 e solicita uma versão rock com vocais. Substitua os espaços reservados pelo ID retornado e pela letra que será cantada.
curl --fail-with-body https://api.mureka.ai/v1/song/remix \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"upload_audio_id": "<UPLOAD_AUDIO_ID>",
"model": "mureka-9.5",
"lyrics": "<LYRICS_FOR_THIS_VERSION>",
"prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
"n": 1
}'
Use n para solicitar várias opções com o mesmo prompt. Para versões rock, EDM e com vocal feminino, reutilize o mesmo ID em três solicitações com direções diferentes. Associe cada tarefa ao ID do áudio original, ao nome da versão e ao ID da tarefa.
Consulte a tarefa e disponibilize a prévia
Salve o ID da tarefa e chame GET /v1/song/query/{task_id}. Durante a geração, exiba um status de espera e continue consultando. Em caso de sucesso, use a URL de áudio para reprodução. Se houver falha, registre o ID e o erro.
curl --fail-with-body \
"https://api.mureka.ai/v1/song/query/${TASK_ID}" \
-H "Authorization: Bearer ${MUREKA_API_KEY}"
Na página de reprodução, use o mesmo nome para a faixa original e os remixes e diferencie as versões pelos nomes. Assim, o usuário pode voltar à original e identificar a versão que está tocando.
Documentação da API