MiniMax Music 2.5 tras una sola llamada REST
La MiniMax Music API expone MiniMax Music 2.5 a través de la misma cuenta, clave de API y modelo de tarea asíncrona que el resto de la plataforma. Envía un prompt que describa la pista junto con la letra — obligatoria para MiniMax Music 2.5, de 10 a 3000 caracteres — y el endpoint devuelve un task_id al instante.
Los resultados llegan por el endpoint de feed dedicado a MiniMax. Consulta GET /v2/minimax/feed?workId=... con tu task_id hasta que el estado sea SUCCESS o FAILED, o pasa callback_url y deja que la plataforma envíe el resultado final a tu webhook. Una tarea completada devuelve la URL del audio generado en el campo response.
Quickstart: genera y consulta el feed
Haz POST a /v2/minimax/generate, guarda el task_id devuelto y consulta el feed de MiniMax hasta que la canción esté lista.
curl -X POST "https://udioapi.pro/api/v2/minimax/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Cinematic orchestral pop, emotional female vocal, warm piano",
"lyrics": "Verse 1: The city lights are fading\nChorus: We rise into the morning glow"
}'
curl -X GET "https://udioapi.pro/api/v2/minimax/feed?workId=YOUR_TASK_ID"Consulta cada 5–10 segundos con un tiempo de espera acotado. Los parámetros opcionales bitrate y sample_rate controlan la codificación de salida.
Parámetros de solicitud de MiniMax Music 2.5
El endpoint de generación acepta un conjunto compacto de parámetros. Una solicitud cuesta 30 créditos — unos $0.30 con 1 USD = 100 créditos.
| Parámetro | Tipo | Obligatorio | Notas |
|---|---|---|---|
| prompt | string | obligatorio | Describe la pista — género, ambiente, instrumentación |
| lyrics | string | obligatorio | 10–3000 caracteres; obligatoria para MiniMax Music 2.5 |
| bitrate | number | opcional | Tasa de bits del audio, p. ej. 256000 |
| sample_rate | number | opcional | Tasa de muestreo del audio, p. ej. 44100 |
| callback_url | string | opcional | Webhook HTTPS público para el resultado final |
| public | boolean | opcional | Si la tarea puede ser pública |
La respuesta devuelve data.task_id y el estado IN_PROGRESS. Consulta /v2/minimax/feed?workId=<task_id> hasta que el estado llegue a SUCCESS (URL de audio en response) o FAILED.
Qué puedes construir
Las tareas de MiniMax conviven con el resto de la API de audio.
Canciones con letra fiel
Suministra la letra completa — obligatoria, de 10 a 3000 caracteres — más un prompt de estilo para contenido vocal determinista.
Leer la documentaciónPistas vocales o instrumentales
Orienta género, ambiente y arreglo mediante el prompt mientras el modelo se encarga de la composición.
Leer la documentaciónMás motores, una sola clave
La misma clave de API también llama a la familia chirp-v6 en /v2/generate cuando necesitas otro sonido.
Leer la documentaciónExtender canciones generadas
Continúa pistas compatibles con el endpoint extend cuando la tarea de origen termine.
Leer la documentaciónConversión a WAV
Convierte el audio generado a WAV para entregarlo en flujos de producción.
Leer la documentaciónCallbacks y estado
Consulta el feed de MiniMax o entrega resultados a tu infraestructura mediante callback_url.
Leer la documentaciónCómo funciona
De la clave de API a una pista reproducible en cuatro pasos.
- 1
Crea una clave de API
Inicia sesión, abre el panel y copia una clave. Guárdala como secreto en el servidor, nunca en el código del navegador.
- 2
Envía prompt y letra
Haz POST a /v2/minimax/generate con prompt, lyrics y campos opcionales de codificación. Guarda data.task_id.
- 3
Consulta el feed de MiniMax
Llama a GET /v2/minimax/feed?workId=<task_id> cada 5–10 segundos, o define callback_url para un webhook.
- 4
Descarga el audio
Con estado SUCCESS, el campo response contiene la URL del audio. Guárdala en tu propio almacenamiento.
Precio fijo por solicitud
Cada solicitud a MiniMax Music 2.5 cuesta 30 créditos — unos $0.30 con 1 USD = 100 créditos. No hace falta suscripción para usar la API; recarga créditos prepagados cuando los necesites.
Los créditos nunca caducan. Las solicitudes rechazadas — por ejemplo, letra ausente o inválida — devuelven 400 y no se facturan como tarea completada.
Límites y notas
- La generación es asíncrona; el POST devuelve un task_id, no audio.
- La letra es obligatoria para MiniMax Music 2.5 y debe tener entre 10 y 3000 caracteres.
- Consulta /v2/minimax/feed cada 5–10 segundos con tiempo acotado, o usa callback_url.
- Las URL de audio son temporales: descarga los resultados a tu propio almacenamiento.
- MiniMax es un motor adicional; el endpoint de generación musical por defecto sigue siendo /v2/generate.
udioapi.pro es un servicio independiente de terceros. No está afiliado, respaldado ni operado por Suno, Udio o MiniMax.
Preguntas frecuentes sobre MiniMax Music API
Respuestas sobre parámetros, facturación y el flujo asíncrono.
¿Es esta la API oficial de MiniMax?
No. udioapi.pro es un servicio de API independiente de terceros con sus propios endpoints, cuentas, créditos, términos y soporte. No está afiliado, respaldado ni operado por MiniMax, Suno o Udio.
¿Cuánto cuesta una solicitud a MiniMax Music 2.5?
Cada solicitud a /v2/minimax/generate cuesta 30 créditos — unos $0.30 con 1 USD = 100 créditos.
¿Es obligatoria la letra?
Sí. MiniMax Music 2.5 exige el campo lyrics con 10–3000 caracteres. Las solicitudes sin letra o con letra inválida se rechazan con una respuesta 400.
¿Cómo obtengo el resultado?
La respuesta de generación devuelve data.task_id. Consulta GET /v2/minimax/feed?workId=<task_id> cada 5–10 segundos hasta SUCCESS, o define callback_url para recibir un webhook. La URL del audio aparece entonces en el campo response.
¿Qué estados veré?
Las tareas comienzan como IN_PROGRESS y terminan como SUCCESS o FAILED. Una tarea fallida informa error_message en el feed, y las solicitudes rechazadas no se facturan como tareas completadas.
¿Hay un modelo más barato para borradores?
Sí. La familia chirp-v6 en /v2/generate incluye chirp-v6-mini a 10 créditos por solicitud — la opción rápida y económica para prototipos.