¿Cómo usar la API de Mureka 9.5? Consigue tu primera canción en 5 minutos

TL;DR

• Qué es: Mureka 9.5 es un modelo de generación musical con dos rutas en HiAPI: letra a canción, donde envías la letra completa y devuelve una canción terminada con voz principal, coros y acompañamiento; y instrumental, donde solo envías una descripción y devuelve música sin voz. Mureka 9.5 ya está disponible en HiAPI; abre la página del modelo letra a canción para escuchar y generar en línea. Los nuevos usuarios reciben 200 créditos al registrarse.
• Cuánto cuesta: cada generación exitosa cuesta $0.3215 (643 créditos); ambas rutas tienen el mismo precio, independientemente de la longitud de la letra y la duración de salida. Si falla, se reembolsa el cargo retenido. Con $10 se generan unas 31 canciones.
• Forma más rápida de empezar: en la página del modelo, pega la letra, elige la voz principal y pulsa ejecutar; para integrarlo en tu propio producto, usa POST /v1/tasks, escribe mureka-9.5/lyrics-to-song en model, obtén el taskId y consulta el estado hasta obtener la URL.

¿Qué es Mureka 9.5?

La letra ya está terminada y lo que falta es una canción cantada: la ruta letra a canción de Mureka 9.5 reduce esto a una sola solicitud. Colocas la letra completa en lyrics, usas el prompt opcional para añadir estilo, emoción, instrumentos, ritmo y características vocales, y fijas con gender si la voz principal es femenina o masculina. Devuelve una canción mezclada en MP3, 44.1 kHz estéreo, aproximadamente 256 kbps.

Los tres casos reales del sitio tienen una duración de 1:49, 3:02 y 3:30 respectivamente; todos provienen de la misma ruta y el mismo precio unitario. No ofrece escritura automática de letras ni acepta canciones de referencia o melodías; el límite de entrada es la letra más una dirección de estilo musical.

Escucha primero dos resultados reales

City Night Drive de la ruta letra a canción y Wide-screen Overture de la ruta instrumental: una sola solicitud y $0.3215 cada una.

Escuchar: City Night Drive, indie pop en inglés, 1:49

Letra a canción: City Night Drive · 1:49 · MP3 44.1 kHz estéreo 256 kbps

Escuchar: Wide-screen Overture, orquesta cinematográfica, 3:12

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

Diferencias entre las dos rutas

	Letra a canción	Instrumental
ID del modelo	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Campos obligatorios	lyrics (1–5,000 caracteres)	prompt (1–1,024 caracteres)
Campos opcionales	prompt (1–2,000 caracteres), gender (female / male)	Ninguno
Salida	Canción completa con voz	Música instrumental sin voz
Duración	La decide el modelo según la estructura de la letra	La decide el modelo; no hay parámetro de duración
Precio unitario	$0.3215 / vez	$0.3215 / vez

Si quieres una canción con voz, usa la ruta izquierda; si quieres música de fondo, usa la derecha. Ninguna de las dos te permite indicar la duración; los tres casos instrumentales del sitio son 3:12, 3:08 y 3:03.

Prueba en línea: 4 pasos

1. Abre la página del modelo letra a canción; en la página puedes escuchar directamente los tres casos del sitio.
2. En el cuadro de letra, pega la letra completa línea por línea y sepárala con marcas de sección como [Verse 1] y [Chorus].
3. En el cuadro de dirección de estilo, escribe el estilo, la emoción, los instrumentos y las características vocales; elige voz principal femenina o masculina.
4. Pulsa «Ejecutar» y, cuando termine la tarea, podrás reproducir y descargar. Cada vez cuesta $0.3215.

Para instrumental, sustituye el paso 2 por una descripción instrumental; abre la página del modelo instrumental y sigue los mismos cuatro pasos.

Para la primera prueba, puedes usar directamente esta dirección de estilo:

Canción indie-pop cálida con una voz principal femenina brillante, guitarras cristalinas, batería en vivo constante y un estribillo amplio para cantar en grupo, ambiente esperanzador de madrugada.

Generar con este prompt →

Al abrirlo, se rellenará el cuadro de dirección de estilo; después pega tus propias cuatro frases de letra, elige voz principal femenina y podrás generar tu primera canción.

Integración con la API: 4 pasos

1. Después de registrarte, crea una API Key en la consola.
2. Usa POST https://api.hiapi.ai/v1/tasks para enviar model e input.
3. Toma el ID de tarea de data.taskId en la respuesta y consulta GET /v1/tasks/{taskId} o espera la devolución de llamada.
4. Cuando el estado cambie a success, toma de data.output el elemento type=audio y descarga el MP3.

Letra a canción: 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": "Canción indie-pop cálida con una voz principal femenina brillante, guitarras cristalinas, batería en vivo constante y un estribillo amplio para cantar en grupo, ambiente esperanzador de madrugada.",
      "gender": "female"
    }
  }'

Toma el ID de tarea de la respuesta:

{"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": "Instrumental orquestal cinematográfico con un ostinato de piano frágil, cuerdas que crecen, metales graves y timbales suaves, esperanzador y luego resuelto, reverberación amplia de banda sonora."
    }
  }'

Consultar el estado:

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

data.status puede ser sucesivamente queued, handling, success o fail.

Python: crear tarea, consultar y obtener enlace

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": "Canción indie-pop cálida con una voz principal femenina brillante, guitarras cristalinas, batería en vivo constante y un estribillo amplio para cantar en grupo, ambiente esperanzador de madrugada.",
        "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"))

Para instrumental se usa la misma lógica de consulta; solo cambia el contenido enviado, y también funciona de forma independiente:

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": "Instrumental orquestal cinematográfico con un ostinato de piano frágil, cuerdas que crecen, metales graves y timbales suaves, esperanzador y luego resuelto, reverberación amplia de banda sonora.",
    },
}

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")))

Salida y formato

Cada solicitud devuelve un MP3 a 44.1 kHz, estéreo, aproximadamente 256 kbps. Al descargar, busca en data.output el elemento cuyo type sea audio; no busques una cadena en el nivel superior de la respuesta.

La url devuelta caduca; antes de guardarla en tu base de datos, transfiere el archivo a tu propio almacenamiento.

Consideraciones antes de publicar

1. Añade consulta periódica como respaldo de la devolución de llamada. El cuerpo de la solicitud puede incluir "callback": {"url": "https://yourapp.com/webhook", "when": "final"}; se notificará cuando la tarea llegue a un estado terminal. La notificación puede perderse, así que añade también una consulta programada.
2. Guarda primero el taskId, no repitas el POST. Cada creación de tarea se cobra una vez; si el cliente agota el tiempo de espera, es posible que la tarea ya se haya creado. Guarda el taskId en la base de datos y consulta el estado antes de reintentar.
3. Segmenta la letra por líneas. Una línea por frase, conserva el orden de estrofas y estribillos y escribe claramente las marcas de sección; la estructura será mucho más estable. Límite de 5,000 caracteres.
4. Indica explícitamente el género de la voz principal. Si no lo envías, lo decide el modelo; para series de canciones o canciones de marca, fija female o male para que la voz sea coherente con el mismo conjunto de materiales.

FAQ

¿Se puede dejar la letra vacía para que el modelo la escriba automáticamente? No. lyrics es obligatorio, de 1 a 5,000 caracteres. Para escritura automática de letras, usa un modelo musical que admita letras automáticas.

¿Cuánto puede durar como máximo una canción? No hay parámetro de duración; la duración la decide el modelo según la estructura de la letra. Los tres casos de letra a canción del sitio son 1:49, 3:02 y 3:30; los tres instrumentales son 3:12, 3:08 y 3:03.

¿El instrumental puede incluir voz? No. La ruta instrumental no genera voz cantada, aunque la descripción mencione una voz principal; si quieres voz, cambia a la ruta letra a canción.

¿Se cobra si la generación falla? No. El importe retenido de las tareas fallidas se reembolsa automáticamente.

Genera ahora tu primera canción

Pega el curl anterior en la terminal, sustituye YOUR_API_KEY por tu key y la letra por la tuya, y obtendrás tu primer taskId. Si quieres ver primero el resultado, abre la página del modelo letra a canción y pulsa ejecutar. Consulta la documentación completa en la documentación de integración de letra a canción y la documentación de integración de instrumental.

Lecturas relacionadas: Precio de Mureka 9.5: $0.3215 por canción · Mureka 9.5 vs MiniMax Music 2.6 · Guía completa de prompts de Mureka 9.5: 6 casos reales