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

POST /v1/song/remix

Parâmetro do modelo

model=mureka-9.5

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

Documentação da API

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