Como usar a API do Mureka 9.5? Faça sua primeira música em 5 minutos

TL;DR

• O que é: o Mureka 9.5 é um modelo de geração musical que tem duas rotas no HiAPI — letra para música, em que você envia a letra completa e recebe uma música pronta com vocal principal, harmonias e acompanhamento; e instrumental, em que você envia apenas uma descrição e recebe uma faixa instrumental sem vocais. O Mureka 9.5 já está disponível no HiAPI: abra a página do modelo letra para música para ouvir e gerar online; novos usuários ganham 200 créditos ao se cadastrar.
• Quanto custa: cada geração bem-sucedida custa $0.3215 (643 créditos), mesmo preço para as duas rotas, independentemente do comprimento da letra e da duração da saída. Em caso de falha, a reserva é reembolsada. Com $10, dá cerca de 31 músicas.
• Como testar o mais rápido possível: na página do modelo, cole a letra, escolha o vocal principal e clique em executar; para integrar ao seu produto, use POST /v1/tasks, defina model como mureka-9.5/lyrics-to-song, pegue o taskId e consulte em polling para obter a URL.

O que é o Mureka 9.5?

A letra já está finalizada, falta a música cantada pronta: a rota letra para música do Mureka 9.5 reduz isso a uma única requisição. Você coloca a letra completa em lyrics, usa o prompt opcional para complementar estilo, emoção, instrumentos, ritmo e características vocais, e usa gender para fixar se o vocal principal é feminino ou masculino. Em uma chamada, retorna uma música mixada, em MP3, 44,1 kHz estéreo, cerca de 256 kbps.

As três músicas reais do site têm durações de 1:49, 3:02 e 3:30, todas da mesma rota e com o mesmo preço unitário. Ele não oferece composição automática de letra nem aceita música de referência ou melodia; o limite de entrada é a letra mais uma direção de estilo.

Ouça primeiro duas faixas reais

City Night Drive, da rota letra para música, e Wide-screen Overture, da rota instrumental, foram geradas com uma única requisição cada, por $0.3215.

Ouvir: City Night Drive, indie pop inglês, 1:49

Letra para música: City Night Drive · 1:49 · MP3 44,1 kHz estéreo 256 kbps

Ouvir: Wide-screen Overture, orquestral cinematográfico, 3:12

Instrumental: Wide-screen Overture · 3:12 · MP3 44,1 kHz estéreo 256 kbps

Qual é a diferença entre as duas rotas

	Letra para música	Instrumental
ID do modelo	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Campo obrigatório	lyrics (1–5.000 caracteres)	prompt (1–1.024 caracteres)
Campos opcionais	prompt (1–2.000 caracteres), gender (female / male)	Nenhum
Saída	Música completa com vocais	Instrumental sem vocais
Duração	Decidida pelo modelo conforme a estrutura da letra	Decidida pelo modelo; não há parâmetro de duração
Preço unitário	$0.3215 / vez	$0.3215 / vez

Para música com vocais, use a rota da esquerda; para trilha sonora, use a da direita. Nenhuma das duas permite preencher a duração; os três exemplos de instrumental do site têm 3:12, 3:08 e 3:03.

Teste online: 4 passos

1. Abra a página do modelo letra para música; na própria página você pode ouvir as três músicas de exemplo do site.
2. No campo de letra, cole a letra completa linha a linha, usando marcadores de seção como [Verse 1], [Chorus] para separar as partes.
3. No campo de direção de estilo, escreva estilo musical, emoção, instrumentos e características vocais; escolha o gênero do vocal principal, feminino ou masculino.
4. Clique em "Executar" e, quando a tarefa terminar, você poderá reproduzir e baixar. Cada vez custa $0.3215.

No instrumental, substitua o passo 2 por uma descrição instrumental; abra a página do modelo instrumental e siga os mesmos quatro passos.

No primeiro teste, você pode usar diretamente esta direção de estilo:

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

Gerar com este prompt →

Ao abrir, ele será preenchido no campo de direção de estilo; cole então quatro versos de sua própria letra, escolha vocal feminino e você poderá gerar sua primeira música.

Integração via API: 4 passos

1. Após o cadastro, crie uma API Key no console.
2. Envie model e input via POST https://api.hiapi.ai/v1/tasks.
3. Pegue o ID da tarefa em data.taskId da resposta e consulte em polling GET /v1/tasks/{taskId} ou aguarde o callback.
4. Quando o status virar success, pegue em data.output o item com type=audio e baixe o MP3.

Letra para música: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

Pegue o ID da tarefa na resposta:

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

Instrumental: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

Consulte o status:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status pode ser, em sequência, queued, handling, success ou fail.

Python: criar tarefa, consultar em polling e obter link

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

O instrumental usa a mesma lógica de polling, mudando apenas o conteúdo enviado; também funciona sozinho:

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

Saída e formato

Cada requisição retorna um MP3, 44,1 kHz, estéreo, cerca de 256 kbps. No download, basta procurar em data.output o item cujo type é audio; não procure uma string no nível superior da resposta.

A url retornada expira; antes de gravar no banco, transfira o arquivo para o seu próprio armazenamento.

Atenção antes de ir para produção

1. Combine callback com polling como fallback. O corpo da requisição pode incluir "callback": {"url": "https://yourapp.com/webhook", "when": "final"}; a notificação é enviada quando a tarefa chega ao estado final. Como a notificação pode se perder, configure também uma consulta periódica como complemento.
2. Salve o taskId primeiro; não faça POST repetido. Cada criação de tarefa é cobrada uma vez; quando o cliente dá timeout, a tarefa pode já ter sido criada. Grave o taskId no banco e consulte o status antes de tentar novamente.
3. Divida a letra por linhas. Uma frase por linha, mantendo a ordem dos versos e refrões, com marcadores de seção bem definidos, deixa a estrutura muito mais estável; o limite é de 5.000 caracteres.
4. Especifique explicitamente o gênero do vocal principal. Se não for enviado, o modelo decide; para séries de músicas ou jingles de marca, fixe female ou male para que a voz saia consistente com o mesmo conjunto de materiais.

FAQ

Posso deixar a letra em branco para o modelo escrever automaticamente? Não. lyrics é obrigatório, de 1 a 5.000 caracteres. Para composição automática de letra, use um modelo musical que suporte letra automática.

Qual é a duração máxima de uma música? Não há parâmetro de duração; o comprimento é decidido pelo modelo conforme a estrutura da letra. As três músicas de exemplo de letra para música do site têm 1:49, 3:02 e 3:30, e os três instrumentais têm 3:12, 3:08 e 3:03.

O instrumental pode gerar vocais? Não. A rota instrumental não gera vocais cantados, mesmo que a descrição mencione vocal principal; se quiser vocais, use a rota letra para música.

Há cobrança em caso de falha na geração? Não. O valor reservado de tarefas com falha é reembolsado automaticamente.

Agora faça sua primeira música

Cole o curl acima no terminal, substitua YOUR_API_KEY pela sua key e a letra pela sua própria; assim você obtém o primeiro taskId. Se quiser ver o resultado primeiro, abra a página do modelo letra para música e clique em executar. A documentação completa está em documentação de integração de letra para música e documentação de integração do instrumental.

Leitura relacionada: Preço do Mureka 9.5: $0.3215 por música · Mureka 9.5 vs MiniMax Music 2.6 · Guia completo de prompts do Mureka 9.5: 6 casos reais