Cómo usar MiniMax Hailuo 02: guía completa

MiniMax Hailuo 02 es un potente modelo de IA para crear vídeos de calidad cinematográfica con un control preciso sobre la imagen, el movimiento y los efectos. Disponible en APIMart, admite texto a vídeo, imagen a vídeo y transiciones basadas en fotogramas, lo que te permite generar clips cortos de alta calidad en resoluciones de hasta 1080p. Esto es lo que necesitas saber:

• Características principales: Crea vídeos a partir de prompts de texto, imágenes o transiciones entre fotogramas, con opciones para movimientos de cámara como [Pan left] o [Zoom in].
• Precios: Los clips en 1080p cuestan 0,08 $/segundo con un 20 % de descuento en APIMart.
• Configuración: Genera una clave API, estructura tu petición con parámetros y usa sondeo asíncrono para recuperar los vídeos.
• Aplicaciones: Ideal para anuncios, presentaciones de productos, storyboards y vídeos de formación.

Para empezar, crea una cuenta en APIMart, protege tu clave API y sigue la guía paso a paso para generar vídeos. Usa prompts específicos y comandos de cámara para maximizar la calidad del vídeo. Para proyectos más largos, une varios clips utilizando fotogramas coherentes o explora Kling V3 como alternativa para generación cinematográfica.

Primeros pasos con MiniMax Hailuo 02 en APIMart

Configuración de la cuenta y acceso a la clave API

Para empezar, dirígete a apimart.ai y crea una cuenta. Si formas parte de un equipo, APIMart te permite configurar una organización. Esta función facilita la colaboración al permitir que todos compartan un saldo central, eliminando la necesidad de intercambiar credenciales personales.

Una vez que tu cuenta esté lista, recarga tu saldo compartido. Este saldo se aplica a los más de 500 modelos disponibles en la plataforma. Esto incluye otras opciones de gama alta como Veo 3.1 para generación de vídeo de nivel profesional. A continuación, ve a la sección Gestión de claves API en el Panel de la Consola y genera una clave API.

Ten en cuenta: tu clave API se muestra solo una vez. Asegúrate de copiarla y guardarla de forma segura, por ejemplo en un gestor de contraseñas o en una bóveda de secretos. Cuando uses la clave en tu código, cárgala desde una variable de entorno (por ejemplo, MINIMAX_API_KEY) en lugar de incrustarla directamente. Esto reduce el riesgo de exposición accidental si tu código se comparte o se sube al control de versiones. Cada petición a la API que hagas incluirá esta clave en el encabezado de autorización:

Authorization: Bearer YOUR_API_KEY

Para equipos, la función Organizaciones es una excelente forma de gestionar el acceso de manera centralizada, evitando la necesidad de compartir credenciales individuales de cuenta ^[2]. Con tu clave API lista, puedes configurar los parámetros de tu petición y empezar a generar vídeos. También puedes explorar Grok Imagine Video para obtener resultados alternativos de alta calidad.

Parámetros clave para las peticiones de MiniMax Hailuo 02

Una vez asegurada tu clave API, deberás configurar tu petición con los parámetros adecuados. El campo "model": "MiniMax-Hailuo-02" es obligatorio, junto con varios otros. Aquí tienes un resumen rápido de los más importantes:

Un detalle importante: la generación de vídeo es asíncrona. Cuando envías una petición, la API responde con un task_id en lugar del vídeo en sí. Tendrás que sondear /v1/tasks/{task_id} cada 15-30 segundos hasta que el estado cambie a "completed". Una vez listo, descarga el vídeo de inmediato, ya que los enlaces generados caducan tras 24 horas ^[2].

Con tus parámetros configurados, ya estás listo para centrarte en crear un prompt eficaz que aproveche al máximo MiniMax Hailuo 02.

Cómo escribir prompts eficaces

Crear un buen prompt es clave para generar vídeos de alta calidad. Un prompt bien estructurado incluye seis elementos: encuadre o movimiento de cámara, sujeto y descripción, acción, escena, iluminación y estilo o ambiente. Por ejemplo, en lugar de una descripción vaga como "una mujer caminando por una ciudad", prueba algo más específico: "[Tracking shot] Una mujer con un abrigo rojo camina con paso firme por una calle de Manhattan empapada por la lluvia al atardecer, con letreros de neón reflejándose en el pavimento mojado, estilo noir cinematográfico."

Para que tus vídeos sean dinámicos, incluye comandos de cámara directamente en tu prompt. Comandos como [Pan left, Pedestal up] pueden añadir movimiento, mientras que otros como [Truck left], [Push in] o [Static shot] ofrecen aún más control sobre la perspectiva ^[3].

Al tratar con escenas complejas, deja prompt_optimizer en true. Esta función refina y amplía automáticamente tu descripción, lo que a menudo se traduce en una salida de vídeo más fluida y coherente con un esfuerzo mínimo ^[1].

Cómo crear vídeos de IA cinematográficos en Hailuo 02

Guía paso a paso: generación de vídeos con MiniMax Hailuo 02

Cómo hacer una petición básica de texto a vídeo a la API

Si ya tienes tu clave API y tu prompt listos, enviar tu primera petición es sencillo. Solo tienes que hacer una llamada POST a https://api.apimart.ai/v1/videos/generations. Incluye tu Bearer Token en el encabezado y usa un cuerpo JSON como este:

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "[Tracking shot] A lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

Importante: la resolución 1080p solo admite clips de 5 segundos. Para un vídeo de 10 segundos, tendrás que bajar la resolución a 768p o 512p. El precio depende tanto de la resolución como de la duración: 768p cuesta 0,04 $ por segundo, mientras que 1080p tiene un precio de 0,08 $ por segundo ^[2].

Cuando envíes la petición, la API devolverá un task_id y un estado de submitted. El vídeo tardará entre 30 y 90 segundos en renderizarse ^[2].

Cómo usar la función de imagen a vídeo

Para las peticiones de imagen a vídeo, tendrás que incluir un parámetro adicional: first_frame_image. Este puede ser una URL pública (por ejemplo, https://example.com/start.jpg) o una cadena de Data URL codificada en Base64. Asegúrate de que la imagen cumpla los requisitos especificados de tipo de archivo, tamaño y relación de aspecto.

Tu prompt debe describir el movimiento, no los detalles visuales de la escena, ya que la imagen aporta ese contexto. Por ejemplo, si tu imagen inicial es un producto sobre una mesa, un prompt como "[Slow zoom in] Product rotates gently, soft studio lighting, clean white background" le indica al modelo cómo animarlo. La resolución de la salida coincidirá con las dimensiones de tu imagen de entrada, por lo que usar una fuente de alta calidad es esencial para obtener resultados nítidos.

Para efectos más avanzados, puedes incluir una last_frame_image junto con tu first_frame_image. Esto crea un vídeo de transición entre dos imágenes, perfecto para cosas como presentaciones de productos, comparaciones de antes y después o transiciones de escena en proyectos más grandes.

Una vez configurada tu petición, supervisa la respuesta de la API para recuperar tu vídeo animado. Para proyectos que requieran audio integrado, considera explorar la API de Veo 3.1, que admite generación de sonido sincronizado.

Lectura de respuestas de la API y descarga de resultados

Cuando el estado de tu tarea cambie a success, la API proporcionará un file_id. Úsalo en una petición separada de "Recuperar archivo" para obtener la download_url. Así funciona el flujo de estados:

Sondea el endpoint /v1/tasks/{task_id} cada 15-30 segundos hasta que el estado cambie a success. Cuando lo haga, solicita el vídeo y descárgalo. Ten en cuenta que los enlaces de descarga caducan tras 24 horas, así que asegúrate de guardar tu archivo de inmediato ^[2].

Si trabajas en Python, puedes usar requests.get(download_url).content para descargar el vídeo y guardarlo como un archivo .mp4. Para evitar el sondeo manual, puedes configurar una callback_url en tu petición. De esta forma, APIMart notificará a tu servidor con una petición POST cuando el estado de la tarea se actualice a success o failed ^[3].

Por último, revisa siempre el campo code en la respuesta de la API. Un valor de 200 significa que la petición fue correcta, pero aún tendrás que supervisar el estado de la tarea para detectar posibles errores de renderizado ^[1][3].

Mejora de la calidad del vídeo e integración del flujo de trabajo

Refinamiento de prompts y configuración de parámetros

Para mejorar la calidad del vídeo, prueba a estructurar los prompts con este formato: [Sujeto y acción], [elemento físico/ambiental], [movimiento de cámara], [iluminación/atmósfera], [descriptor de calidad] ^[7]. Aquí tienes un ejemplo: "Un barista vierte leche humeante en un espresso, el líquido se arremolina a cámara lenta, [Zoom in], cálida iluminación de cafetería, calidad cinematográfica." Este enfoque ayuda al modelo a simular un movimiento y una atmósfera realistas de forma más eficaz.

MiniMax-Hailuo-2.3 ofrece 15 comandos de cámara, que puedes combinar (hasta tres) en un solo conjunto de corchetes, como [Pan left, Pedestal up] ^[3]. Usa la siguiente tabla como referencia rápida:

Por defecto, la función prompt_optimizer está activada, lo que generalmente mejora la calidad de la salida. Déjala activada a menos que necesites que el modelo siga un guion muy específico. Si tu prioridad es la velocidad y no te importa un acabado menos pulido, establece fast_pretreatment: true para reducir el tiempo de preprocesamiento ^[1][6].

Una vez ajustados tus prompts y configuraciones, intégralos en un pipeline más amplio para elevar la calidad de tu producción.

Construcción de pipelines multimodelo con APIMart

Hailuo 02 funciona mejor cuando se combina con herramientas complementarias para audio y secuencias extendidas. Aunque destaca creando metraje B-roll visualmente dinámico —como agua, fuego o tejidos—, no genera audio. Para llenar este vacío, combínalo con herramientas de MiniMax Audio, como Speech 2.8 para voces en off o Music 2.6 para bandas sonoras, durante la postproducción ^[8]. Para proyectos de marca o comerciales, empieza con un modelo de imagen para generar un fotograma base y luego introdúcelo en Hailuo 02 como first_frame_image para un control preciso sobre la composición ^[7].

Para vídeos de más de 10 segundos, haz una captura de pantalla del último fotograma de un clip terminado y úsala como first_frame_image para la siguiente petición. Esta técnica garantiza la coherencia en los detalles del personaje y la iluminación del entorno a lo largo de varios clips ^[8].

"¡La consistencia de MiniMax Hailuo 02 es increíble! Las imágenes de los personajes se mantienen estables a lo largo de varios clips." - Wei Zhang, animador independiente ^[2]

Gestión de errores y buenas prácticas de la API

Incluso con prompts y pipelines refinados, pueden surgir problemas. Sigue estas buenas prácticas para solucionar problemas y optimizar las respuestas de la API de forma eficaz.

Los dos fallos más comunes con Hailuo 02 tienen que ver con combinaciones de resolución/duración no compatibles y entradas de imagen no válidas. Comprueba siempre que tus ajustes de resolución y duración sean compatibles ^[1][6]. Para las tareas de imagen a vídeo, asegúrate de que tu imagen de origen pese menos de 20 MB, tenga un borde corto superior a 300 px y una relación de aspecto entre 2:5 y 5:2. Los formatos aceptados incluyen JPG, PNG y WebP ^[5].

Cuando una tarea falla, revisa siempre el campo error_message en la respuesta JSON. Proporciona diagnósticos detallados que ayudan a resolver los problemas con rapidez ^[4]. Para configuraciones de producción, usa el parámetro callback_url en lugar del sondeo manual. Esto reduce las llamadas innecesarias a la API y mantiene tu flujo de trabajo ágil ^[3].

Conclusión: puntos clave

Aquí tienes un resumen rápido de lo que hace de MiniMax Hailuo 02 una herramienta destacada para la generación de vídeo.

MiniMax Hailuo 02 ofrece creación de vídeo de calidad cinematográfica con una precisión increíble. Gracias a su arquitectura NCR, que cuenta con 3 veces más parámetros y 4 veces más datos de entrenamiento que los modelos anteriores ^[7], produce efectos muy realistas para elementos complejos como el agua, el fuego, el humo y los tejidos.

A través de APIMart, puedes conseguir un 20 % de descuento, junto con precios competitivos tanto para las resoluciones 768p y 1080p ^[2]. Cuenta con un SLA de disponibilidad del 99,9 % y tiempos de generación típicos de solo 30 a 90 segundos ^[2], lo que lo convierte en una opción práctica para todo, desde la producción profesional hasta la experimentación creativa. Para quienes necesiten un espacio de trabajo más visual, un editor de lienzo de IA puede agilizar aún más el proceso de edición.

Las características más destacadas del modelo incluyen:

• Herramientas de imagen a vídeo para un control preciso.
• Comandos de cámara entre corchetes (por ejemplo, [Tracking shot], [Zoom in]) para una cinematografía de nivel profesional.
• Continuidad del último fotograma, que garantiza transiciones fluidas para secuencias extendidas.

Los usuarios han elogiado su fiabilidad y velocidad. Como comparte David Chen, ingeniero Full-Stack:

"Valoro la estabilidad y la velocidad. MiniMax Hailuo 02 ofrece un rendimiento excepcional." ^[2]

Ten en cuenta que los clips en 1080p están limitados a 5-6 segundos. Para vídeos más largos, 768p es una excelente alternativa, ya que ofrece una calidad constante a un precio competitivo ^[1][3].

Con estas características, MiniMax Hailuo 02 está listo para elevar tu flujo de trabajo de producción de vídeo al siguiente nivel.

Preguntas frecuentes

¿Cómo hago clips de más de 10 segundos?

MiniMax Hailuo 02 tiene un límite máximo de duración de clip de 10 segundos. Si necesitas clips más largos, tendrás que trabajar dentro de esta restricción. Establece la duración en 10 segundos y elige una resolución compatible, como 768p o 1080p, en tu petición.

Para las tareas de texto a vídeo, incluye los siguientes parámetros en tu petición:

• duration: 10
• resolution: "768P"
• model: "MiniMax-Hailuo-02"

Tras enviar la petición, comprueba el estado de la tarea y descarga el archivo generado una vez que esté listo.

¿Qué debo hacer si mi tarea falla?

Si tu tarea de generación de vídeo no se completa, empieza revisando el mensaje de estado de la API para identificar el problema. Aquí tienes algunos códigos de error comunes que conviene vigilar:

• 1002: Indica que has alcanzado los límites de tasa.
• 1004/2049: Apunta a problemas de autenticación.
• 1008: Señala un saldo insuficiente en tu cuenta.
• 1026: Marca contenido sensible en la entrada.

Para errores de límite de tasa (HTTP 429) o problemas relacionados con el servidor (HTTP 5xx), prueba a implementar retroceso exponencial: esto significa añadir retrasos progresivamente más largos entre reintentos. Además, revisa dos veces tus parámetros de entrada y asegúrate de que tus prompts eviten el contenido sensible para evitar errores de validación.

¿Cómo puedo mantener la coherencia de los personajes entre clips?

Para mantener la coherencia de los personajes en MiniMax Hailuo 02, opta por el modo de referencia de sujeto (Subject Reference) y usa una imagen de referencia clara y bien iluminada. Si trabajas con varios clips, garantiza la coherencia incluyendo detalles de iluminación que coincidan en tus prompts. Para un flujo visual más fluido, alinea los ángulos de cámara entre las tomas y considera transiciones sutiles como fundidos cruzados o match-cuts durante la postproducción. Estas técnicas ayudan a crear una narrativa cohesionada y pulida.