MiniMax
MiniMax Music 1.5
minimax-music-1.5
Modelo de texto a música: genera una canción completa con voz y acompañamiento en una sola pasada a partir de una descripción de estilo y una letra; cada canción puede durar hasta unos 4 minutos y admite la organización por secciones mediante etiquetas de estructura
Probar minimax-music-1.5
Entrada
Creaciones
Ver todas las creacionesSalida
Precios
minimax-music-1.5 per song
| Precio unitario | $0.070 |
|---|
Descripción general
minimax-music-1.5 es el modelo de texto a música de MiniMax, disponible a través de la interfaz unificada de HiAPI.ai. Basta con introducir un prompt de estilo y una letra con etiquetas de estructura para generar una canción completa con voz cantada e instrumentación por capas; el modelo se encarga del arreglo, la mezcla y la interpretación vocal, sin que el creador tenga que tocar ni grabar nada. Es adecuado para integrarse en flujos de trabajo de bandas sonoras de vídeos y series cortas, demos de artistas virtuales y desarrolladores sin formación en producción musical que quieran crear canciones rápidamente según una emoción o un escenario.
Puntos clave
- La letra define directamente la estructura de la canción: la letra admite etiquetas de estructura como [intro][verse][chorus][bridge][outro], lo que permite especificar el contenido por secciones y logra transiciones más coherentes entre las partes de la pieza generada.
- El prompt controla el estilo y la emoción: el prompt de estilo puede describir el género, la emoción y la instrumentación; el modelo realiza el arreglo y la interpretación vocal a partir de ello, reduciendo el ajuste manual de parámetros.
- Especificaciones de salida configurables: permite elegir entre los formatos mp3, wav y pcm, así como indicar la frecuencia de muestreo y la tasa de bits para adaptarse a los flujos posteriores de reproducción o edición.
Capacidades
Generación de canciones completas a partir de la letra: con una letra de entre 10 y 600 caracteres y un prompt de estilo de entre 10 y 300 caracteres, el modelo genera en una sola pasada una canción con voz y acompañamiento, y el desarrollador obtiene directamente un archivo de audio utilizable.
Organización de secciones mediante etiquetas de estructura: el uso de etiquetas como [intro][verse][chorus] en la letra delimita las secciones y deja clara la posición y la repetición de estrofas y estribillos, lo que mejora la coherencia de la forma musical del resultado.
Control del estilo y la emoción mediante texto: el prompt describe el género, la emoción y la instrumentación para adaptarse a las necesidades de banda sonora de distintos temas, sin cambiar de modelo para cada estilo.
Parámetros de audio de salida opcionales: se puede indicar en la solicitud el formato de audio, la frecuencia de muestreo y la tasa de bits para entregar archivos con las especificaciones que exija el reproductor o el proceso de postproducción posterior.
Casos de uso
- Producción de bandas sonoras para creadores de vídeos cortos y series cortas: escribir un prompt acorde a la emoción de la trama y adjuntar la letra para generar un tema principal o una canción insertada con voz, lista para el montaje y la publicación del vídeo.
- Demos de canciones para operadores de artistas virtuales: producir rápidamente canciones completas con voz a partir de un prompt de estilo y una letra, como material de obra o demo de presentación de un cantante virtual.
- Creación rápida de canciones para creadores sin formación musical: basta con aportar una descripción de la emoción o el escenario y una letra propia para obtener una canción con arreglo y mezcla terminados, destinada a la publicación de contenido o a un evento.
Limitaciones y recomendaciones de elección
Solo admite la generación de canciones a partir de la letra proporcionada por el usuario y no ofrece escritura automática de letras; tampoco admite el modo puramente instrumental, por lo que para acompañamientos sin voz conviene elegir otro modelo. La letra tiene un límite de 600 caracteres, y las composiciones largas o de múltiples secciones complejas requieren simplificar y priorizar. El resultado depende de la calidad del prompt y de la letra; se recomienda usar etiquetas de estructura para delimitar las secciones. Si se necesitan capacidades de control más avanzadas, puede considerarse una versión superior de la misma familia.
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-1.5
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para minimax-music-1.5 y la ruta default; consulta la tabla de parámetros a continuación.
lyricsstringObligatoriominLength 10maxLength 600Letra de la canción, una frase por línea (separadas por \n), con una longitud limitada de 10 a 600 caracteres; admite etiquetas de estructura [intro][verse][chorus][bridge][outro].
promptstringObligatoriominLength 10maxLength 300Indicación de texto que controla el estilo musical, usada para describir el estilo, el estado de ánimo y la instrumentación, con una longitud limitada de 10 a 300 caracteres.
bitrateintegerOpcionalPredeterminado: 256000Tasa de bits del audio de salida, en bps, por defecto 256000.
3200064000128000256000sample_rateintegerOpcionalPredeterminado: 44100Frecuencia de muestreo del audio de salida, en Hz, por defecto 44100.
16000240003200044100audio_formatstringOpcionalPredeterminado: "mp3"Formato del audio de salida, por defecto mp3.
mp3wavpcmcallbackobjectOpcional
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-1.5",
"input": {
"lyrics": "…",
"prompt": "…",
"bitrate": 256000,
"sample_rate": 44100,
"audio_format": "mp3"
}
}' 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-1.5",
input: {
"lyrics": "…",
"prompt": "…",
"bitrate": 256000,
"sample_rate": 44100,
"audio_format": "mp3"
}
}),
});
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-1.5",
"input": {
"lyrics": "…",
"prompt": "…",
"bitrate": 256000,
"sample_rate": 44100,
"audio_format": "mp3"
}
},
)
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 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
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 kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
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
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
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
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Lyria 3.5 Google $0.090 /canción -
MiniMax Music 3 MiniMax $0.0026 /segundo -
Gemini 3.1 Flash TTS Google -- -
Mureka 9.5 Mureka $0.322 per request -
Lyria 3 Pro Google $0.140 /canción -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
Mirelo SFX 2.0 Mirelo AI $0.021 /segundo -
ElevenLabs ElevenLabs $0.0029 /segundo -
MiniMax Music 2.6 MiniMax $0.210 /canción



