MiniMax
MiniMax Music 3
minimax-music-3
Introduce la letra y la descripción musical para generar una canción estéreo de hasta unos 5 minutos, con voz y una estructura musical completa, ideal para producir rápidamente demos de canciones y música de fondo personalizada.
Probar minimax-music-3
Entrada
Creaciones
Ver todas las creacionesSalida
audioPrecios
minimax-music-3 per second
| Precio unitario | $0.0026 |
|---|
Descripción general
minimax-music-3 es un modelo de generación de música a partir de texto lanzado por MiniMax, que se invoca a través de la interfaz unificada de HiAPI.ai. Al introducir una letra y una descripción musical, se puede generar una canción completa con voz cantada y arreglos musicales completos, compatible con estructuras de secciones como intro, estrofa, estribillo, puente y outro, con una duración por generación que puede controlarse dentro de unos pocos minutos. Es adecuado para desarrolladores y equipos de contenido que necesitan producir demos de canciones en lote, personalizar música de fondo o convertir letras ya existentes en audio.
Aspectos destacados
- Control dual mediante letra y descripción: la letra se anota por líneas con etiquetas de sección; el texto de descripción puede especificar género, BPM, tonalidad y estilo vocal, controlando por separado la estructura y el estilo.
- Forma musical completa en lugar de fragmentos: el resultado generado incluye una disposición organizada de secciones desde la intro hasta el outro, junto con la voz cantada, y puede usarse directamente como esbozo de una canción terminada.
- Arquitectura por capas que equilibra estructura y detalles vocales: la capa global se encarga del desarrollo de la forma musical a largo plazo y la capa local procesa los detalles acústicos a nivel de fotograma, lo que hace más estable la transición entre secciones en audios largos.
- Duración con límite superior configurable en segundos: el parámetro duration admite de 1 a 300 segundos; el modelo puede finalizar antes, lo que facilita controlar la salida según la duración del material.
Descripción de capacidades
Generación de forma musical estructurada: organiza automáticamente intro, estrofa, preestribillo, estribillo, puente, sección instrumental y outro; basta con escribir etiquetas por línea en la letra para asignar cada sección. Las líneas sin etiquetar se descartan, por lo que es necesario preparar el formato de la letra de antemano.
Control condicional de atributos musicales: el prompt puede describir género, BPM, tonalidad, evolución emocional, instrumentación y detalles vocales; cuanto más concreta sea la descripción, más precisa será la orientación del estilo, lo que resulta adecuado para la creación en lote con una identidad estilística estable.
Límite superior de duración: duration establece en segundos la longitud máxima de generación, con 60 segundos por defecto y un rango de 1 a 300 segundos; el modelo puede terminar antes, lo que facilita ajustar la salida a la duración de fragmentos de vídeo o pódcast.
Generación reproducible: ofrece el parámetro seed; una misma entrada con una semilla fija permite reproducir el mismo resultado. Si se omite, se usa una semilla aleatoria, lo que resulta útil para comparar descripciones distintas o gestionar versiones.
Especificaciones fijas de salida de audio: la salida es WAV estéreo de 32 kHz y 16 bits, lista para entrar directamente en el flujo de edición o mezcla sin necesidad de transcodificación adicional.
Casos de uso
- Producción rápida de demos de canciones por músicos: al introducir una letra completa y una descripción de estilo se obtiene un esbozo de canción terminada con voz y arreglos, útil para mostrar la dirección a equipos o clientes.
- Música de fondo personalizada para equipos de vídeo y videojuegos: genera música de fondo según BPM y descripción emocional, ajusta la duración a la longitud del metraje e insértala directamente en la pista de edición o de audio del juego.
- Conversión de letras existentes en canciones: introduce letras ya escritas organizadas con etiquetas de sección y, junto con una descripción de estilo, conviértelas en una versión cantada lista para escuchar.
- Exploración en lote por género y emoción: con una semilla fija y varios conjuntos de descripciones, compara resultados generados en distintos géneros y tonalidades para filtrar rápidamente material utilizable.
Limitaciones y recomendaciones de selección
La fidelidad con estilos musicales no occidentales es limitada, y las indicaciones con un carácter estilístico marcado pueden desviarse de lo esperado; la ficha del modelo no declara capacidad de canto multilingüe, por lo que las letras que no estén en inglés deben validarse primero con una muestra breve. El límite por generación es de aproximadamente 5 minutos y la salida es siempre WAV estéreo de 32 kHz y 16 bits, sin otras opciones de frecuencia de muestreo o codificación. Si se necesitan obras completas más largas o un canto multilingüe estricto, conviene validar primero el efecto en fragmentos cortos y después decidir si se adopta.
Novedades
Ver el registro de cambios →- Nuevo modelo Nuevo modelo: minimax-music-3 — generación de canciones de alta fidelidad de MiniMax, con duración controlable. La letra es obligatoria…
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: minimax-music-3
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para minimax-music-3 y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalSemilla aleatoria para reproducir el resultado; use un número entero, si se omite se utiliza una semilla aleatoria.
lyricsstringObligatorioTexto de la letra que se va a cantar; las etiquetas de estructura como [intro], [verse], [chorus], etc. deben ocupar cada una su propia línea, el texto que comparta línea con una etiqueta se descarta.
promptstringObligatorioDescripción musical que especifica el estilo, el estado de ánimo, la voz, la instrumentación y los arreglos; cuando se requiera un control preciso puede incluir género, BPM, tonalidad, progresión emocional, detalles vocales y arreglos sección por sección.
durationnumberOpcionalPredeterminado: 60min 1max 300Duración máxima del audio generado, en segundos; el modelo puede terminar antes. Valor predeterminado: 60 segundos.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-music-3",
"input": {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-music-3",
input: {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-music-3",
"input": {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Mureka 9.5 Mureka $0.322 per request -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
ElevenLabs ElevenLabs $0.0029 /segundo -
Gemini 3.1 Flash TTS Google -- -
Mirelo SFX 2.0 Mirelo AI $0.021 /segundo -
Lyria 3 Pro Google $0.140 /canción -
MiniMax Music 1.5 MiniMax $0.070 /canción -
Lyria 3.5 Google $0.090 /canción -
MiniMax Music 2.6 MiniMax $0.210 /canción



