MiniMax

MiniMax Music 2.6

minimax-music-2.6

Modelo de generación de canciones completas a partir de texto, con voz e instrumental, que añade adaptación al estilo AI Cover y escritura automática de letras, con una latencia de primera salida declarada de menos de 20 segundos

minimax-music-2.6

Probar minimax-music-2.6

Entrada

Lyrics

Instrumental

Creaciones

Ver todas las creaciones

Salida

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

minimax-music-2.6 per song

Precio unitario	$0.210

Descripción general

minimax-music-2.6 es el modelo de generación de canciones a partir de texto de MiniMax, que se invoca a través de la interfaz unificada de HiAPI.ai. Basta con introducir un prompt de estilo para generar una canción completa con voz y múltiples capas instrumentales; también se puede escribir solo el prompt y dejar que componga la letra automáticamente, o cambiar al modo puramente instrumental para obtener una banda sonora sin voz. La letra admite etiquetas estructurales para controlar la disposición de las secciones, y el formato de salida, el bitrate y la frecuencia de muestreo se pueden especificar según sea necesario. Es adecuado para desarrolladores y equipos de contenido que necesitan producir por lotes bandas sonoras originales, demos de canciones y material para adaptaciones de estilo.

Puntos clave

Producción integral de canciones completas: una sola llamada devuelve una pieza terminada con voz, instrumentos y mezcla según el género, no fragmentos de material, lo que evita ensamblar varias pistas.
Letra generada automáticamente: el prompt basta para que el modelo escriba la letra y componga la canción; sin capacidad de escribir letras también se obtiene directamente una obra con voz.
Control de la estructura mediante etiquetas de letra: se usan etiquetas como Intro, Verse, Chorus y Bridge para dividir las secciones y determinar la progresión de la canción.
Especificaciones de salida opcionales: admite tres formatos, mp3, wav y pcm, con bitrate y frecuencia de muestreo seleccionables entre los niveles definidos en el esquema, lo que facilita integrarse en flujos posteriores.

Descripción de capacidades

Texto a canción: al introducir descripciones de estilo, emoción y escenario, el modelo genera una canción completa con voz y múltiples capas instrumentales, utilizable directamente como material final o como demo.

Generación puramente instrumental: al activar el modo instrumental no hace falta proporcionar letra; se obtiene una base o pieza instrumental sin voz, adecuada para necesidades de música de fondo.

Composición automática de la letra: cuando el campo de letra se deja vacío, el modelo genera la letra a partir del prompt, lo que reduce la barrera de escribir desde cero; si se necesita un control preciso, se puede seguir proporcionando la letra.

Arreglo estructurado: se pueden incrustar etiquetas de estructura de secciones en la letra para controlar la disposición de la introducción, los versos, el estribillo y los interludios, de modo que la estructura de la salida se ajuste mejor a lo esperado.

Parámetros de salida controlables: se puede especificar el formato de audio, el bitrate y la frecuencia de muestreo, eligiendo la especificación de salida adecuada según el montaje, la distribución o la reproducción posteriores.

Escenarios de aplicación

Creación de bandas sonoras para videos cortos y pódcasts: con descripciones de estilo y emoción como entrada, se produce música de fondo que puede colocarse directamente en videos o pódcasts, reduciendo la dependencia de bibliotecas musicales externas.
Validación de demos de canciones por compositores y letristas: al enviar un prompt de estilo y una letra de prueba, se obtiene rápidamente una demo completa con voz para validar la dirección de la melodía y el arreglo.
Creación integral sin capacidad de escribir letras: una sola descripción de escenario impulsa la escritura automática de la letra y la generación de la canción, produciendo temas originales utilizables en eventos, publicidad o distribución de contenido.
Producción por lotes de bases instrumentales: al activar el modo instrumental, se generan por lotes bases sin voz para locución, presentaciones o videojuegos, escenarios que requieren dejar espacio a la voz.

Limitaciones y recomendaciones de selección

El campo de letra tiene un límite de 3500 caracteres y el prompt de estilo de 2000 caracteres; el contenido demasiado largo debe resumirse antes. El resultado depende en gran medida de la calidad del prompt, por lo que se recomienda revisar manualmente la letra generada automáticamente antes de usarla. Si la necesidad es adaptar el estilo de una canción existente o se trata de una interacción con requisitos de tiempo real muy altos, las capacidades actuales de los parámetros no cubren ese uso y conviene elegir otro modelo que admita la forma de entrada correspondiente.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El 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-KeystringOpcional

Clave 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.

Clave de idempotencia

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

modelstringObligatorio

Valor fijo actual: minimax-music-2.6

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para minimax-music-2.6 y la ruta default; consulta la tabla de parámetros a continuación.

lyricsstringOpcionalminLength 1maxLength 3500

Letra de la canción, de 1 a 3500 caracteres, con líneas separadas por \n; admite etiquetas estructurales como [Intro], [Verse], [Chorus] para controlar las secciones del arreglo. Si se deja vacío, la letra se genera automáticamente a partir de prompt; cuando is_instrumental es true, no es necesario proporcionarla.

promptstringObligatoriominLength 1maxLength 2000

Texto descriptivo del estilo musical, el estado de ánimo y la escena, por ejemplo «pop, melancólico, ideal para una noche de lluvia», con un máximo de 2000 caracteres.

bitrateintegerOpcionalPredeterminado: 256000

Tasa de bits del audio de salida, en bps, por defecto 256000.

Opciones:3200064000128000256000

sample_rateintegerOpcionalPredeterminado: 44100

Frecuencia de muestreo del audio de salida, en Hz, por defecto 44100.

Opciones:16000240003200044100

audio_formatstringOpcionalPredeterminado: "mp3"

Formato del audio de salida, por defecto mp3.

Opciones:mp3wavpcm

is_instrumentalbooleanOpcionalPredeterminado: false

Indica si se genera música puramente instrumental sin voz; cuando es true, no es necesario proporcionar la letra, por defecto false.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

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.

urlstringObligatorio

Obligatorio 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.

Opciones:final

storagestringOpcionalPredeterminado: "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.

Opciones:temppersistent

Ejemplos 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-2.6",
  "input": {
    "prompt": "…",
    "bitrate": 256000,
    "sample_rate": 44100,
    "audio_format": "mp3",
    "is_instrumental": false
  }
}'

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-2.6",
    input: {
      "prompt": "…",
      "bitrate": 256000,
      "sample_rate": 44100,
      "audio_format": "mp3",
      "is_instrumental": false
    }
  }),
});
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-2.6",
        "input": {
          "prompt": "…",
          "bitrate": 256000,
          "sample_rate": 44100,
          "audio_format": "mp3",
          "is_instrumental": False
        }
    },
)
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

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre 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.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

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.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos 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

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripció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"
    }
  }
}