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

MiniMax Hailuo 02 es un potente modelo de IA para crear vídeos con calidad cinematográfica y un control preciso de la imagen, el movimiento y los efectos. Está disponible en APIMart a través de MiniMax Hailuo 02 API y admite texto a vídeo, imagen a vídeo y transiciones entre primer y último fotograma, para generar clips cortos de alta calidad en resoluciones de hasta 1080p. Esto es lo que necesitas saber:

• Funciones clave: crea vídeos a partir de prompts de texto, de un primer fotograma o de un par de primer y último fotograma, y describe el movimiento de cámara directamente en el prompt.
• Precios: a octubre de 2026, los clips en 1080p cuestan $0,08 por segundo en APIMart; consulta la página del modelo para ver las tarifas actuales.
• Configuración: genera una clave API, estructura la petición con sus parámetros y usa consultas asíncronas para obtener los vídeos.
• Aplicaciones: ideal para anuncios, presentaciones de producto, storyboards y vídeos de formación.

Para empezar, crea una cuenta en APIMart, guarda tu clave API y sigue la guía paso a paso para generar vídeos. Usa prompts concretos e indicaciones de cámara claras para sacar el máximo partido a la calidad. Para proyectos más largos, une varios clips con fotogramas coherentes o prueba Kling V3 API como alternativa de generación cinematográfica.

Puntos clave

• MiniMax Hailuo 02 genera a través de APIMart clips de texto a vídeo, imagen a vídeo y transiciones del primer al último fotograma de hasta 1080p, con el ID de modelo MiniMax-Hailuo-02.
• El flujo es: crear una cuenta en APIMart, generar en API Key Management una clave que solo se muestra una vez, enviar un cuerpo JSON por POST a https://api.apimart.ai/v1/videos/generations y consultar /v1/tasks/{task_id} cada 15–30 segundos hasta que el estado sea completed.
• Los parámetros clave son prompt, duration de 5 o 10 segundos, resolution de 512p, 768p o 1080p, first_frame_image y last_frame_image como URL pública o Base64, y prompt_optimizer, activado por defecto.
• A octubre de 2026, Hailuo 02 cuesta en APIMart $0,0104 por segundo en 512p, $0,04 en 768p y $0,08 en 1080p; el vídeo terminado se lee en data.result.videos[0].url[0] y los resultados se conservan 72 horas, así que guarda los archivos cuanto antes.
• En APIMart, 1080p solo admite clips de 5 segundos y no hay audio nativo; los vídeos de más de 10 segundos se encadenan usando el último fotograma como siguiente first_frame_image.

MiniMax Hailuo 02 de un vistazo

Primeros pasos con MiniMax Hailuo 02 en APIMart

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

Para empezar, entra en apimart.ai y crea una cuenta. Si trabajas en equipo, APIMart te permite crear una organización. Así todos comparten un saldo central y la colaboración es más sencilla, sin tener que intercambiar credenciales personales.

Cuando la cuenta esté lista, recarga el saldo compartido. Ese saldo sirve para todos los modelos de APIMart, incluidas opciones de gama alta como Veo 3.1 API para generación de vídeo profesional. Después, ve a la sección API Key Management del panel de la consola y genera una clave API.

Ten en cuenta: tu clave API solo se muestra una vez. Cópiala y guárdala en un lugar seguro, como un gestor de contraseñas o un almacén de secretos. Cuando la uses en tu código, cárgala desde una variable de entorno (por ejemplo, APIMART_API_KEY) en lugar de incrustarla directamente. Así reduces el riesgo de exponerla por accidente si compartes el código o lo subes a un control de versiones. Cada petición a la API incluirá esta clave en la cabecera de autorización:

Authorization: Bearer YOUR_API_KEY

Para equipos, la función Organizations es una buena forma de gestionar el acceso de forma centralizada sin compartir credenciales individuales ^[2]. Con la clave API lista, puedes configurar los parámetros de la petición y empezar a generar vídeos. También puedes probar Grok Imagine Video API como alternativa de alta calidad.

Parámetros clave de las peticiones a MiniMax Hailuo 02

Una vez asegurada la clave API, tendrás que configurar la petición con los parámetros adecuados. El campo "model": "MiniMax-Hailuo-02" es obligatorio, junto con algunos otros. Estos son 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. Tendrás que consultar /v1/tasks/{task_id} cada 15–30 segundos hasta que el estado cambie a "completed". Cuando esté listo, descárgalo cuanto antes: los resultados se conservan 72 horas ^[1].

Con los parámetros listos, puedes centrarte en escribir un prompt eficaz para aprovechar al máximo MiniMax Hailuo 02.

Cómo escribir prompts eficaces

Un buen prompt es clave para generar vídeos de calidad. Un prompt bien estructurado incluye seis elementos: plano 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 la ciudad», prueba algo más concreto: «Plano de seguimiento: una mujer con abrigo rojo camina a paso rápido por una calle de Manhattan empapada por la lluvia al atardecer, los letreros de neón se reflejan en el pavimento mojado, estilo noir cinematográfico.»

Para dar dinamismo a tus vídeos, describe el movimiento de cámara con palabras sencillas al inicio del prompt, como «push in lento», «plano de seguimiento» o «plano fijo». La documentación de Hailuo 02 en APIMart no incluye una lista de comandos de cámara entre corchetes; los 15 comandos en chino entre corchetes que se explican más adelante en esta guía están documentados para Hailuo 2.3.

En escenas complejas, deja prompt_optimizer en true. Esta función refina y amplía tu descripción automáticamente, lo que a menudo da como resultado un vídeo más fluido y coherente con muy poco esfuerzo ^[1].

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

Guía paso a paso: generar vídeos con MiniMax Hailuo 02

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

Si ya tienes la clave API y el prompt, enviar tu primera petición es fácil. Haz una llamada POST a https://api.apimart.ai/v1/videos/generations, incluye tu token Bearer en la cabecera 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 a 768p o 512p. El precio depende de la resolución y la duración. A octubre de 2026, 768p cuesta $0,04 por segundo y 1080p $0,08 por segundo; consulta la página del modelo para ver las tarifas actuales.

Al enviar la petición, la API devuelve un task_id en data[0].task_id con el estado submitted. El tiempo de render depende de la resolución, la duración y la carga del momento, así que sigue consultando hasta que la tarea termine.

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. Puede ser una URL pública (por ejemplo, https://example.com/start.jpg) o una cadena Data URL codificada en Base64. Asegúrate de que la imagen cumple los requisitos de tipo de archivo, tamaño y relación de aspecto.

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

Para efectos más avanzados, puedes incluir un last_frame_image junto con tu first_frame_image. Así se crea un vídeo de transición entre dos imágenes, perfecto para revelaciones de producto, comparativas de antes y después o transiciones de escena en proyectos más grandes.

Una vez configurada la petición, sigue la respuesta de la API para obtener tu vídeo animado. Para proyectos que necesitan audio integrado, puedes considerar la API de Veo 3.1, que genera sonido sincronizado.

Cómo leer las respuestas de la API y descargar los resultados

Consulta GET https://api.apimart.ai/v1/tasks/{task_id}. Cuando el estado de la tarea cambia a completed, la URL del vídeo está en data.result.videos[0].url[0]. No hay un ID de archivo aparte ni un endpoint de descarga. Así funciona el flujo de estados:

Consulta el endpoint /v1/tasks/{task_id} cada 15–30 segundos hasta que el estado cambie a completed. Después, descarga el vídeo desde la URL devuelta. Los resultados se conservan 72 horas, así que guarda el archivo en tu propio almacenamiento cuanto antes ^[1].

Si trabajas en Python, puedes usar requests.get(video_url).content para descargar el vídeo y guardarlo como archivo .mp4, donde video_url es data["result"]["videos"][0]["url"][0] de la respuesta de la tarea.

Por último, revisa siempre el campo code de la respuesta de la API. Un valor 200 significa que la petición se realizó correctamente, pero aun así debes vigilar el estado de la tarea por si hay errores de render ^[1].

Mejorar la calidad del vídeo e integrar el flujo de trabajo

Refinar los prompts y los parámetros

Para mejorar la calidad del vídeo, estructura los prompts con este formato: [Sujeto y acción], [elemento físico/ambiental], [movimiento de cámara], [iluminación/ambiente], [descriptor de calidad] ^[7]. Un ejemplo: «Un barista vierte leche humeante en un espresso, el líquido gira a cámara lenta, zoom in lento, luz cálida de cafetería, calidad cinematográfica.» Este enfoque ayuda al modelo a simular con más eficacia un movimiento y un ambiente realistas.

Si necesitas etiquetas de cámara explícitas, MiniMax Hailuo 2.3 API en APIMart admite 15 comandos de cámara en chino entre corchetes, que se colocan al inicio del prompt con las etiquetas exactas ^[3]. Usa esta tabla como referencia rápida:

La función prompt_optimizer viene activada por defecto y suele mejorar la calidad de salida. Déjala activada salvo que necesites que el modelo siga un guion muy concreto. Si priorizas la velocidad y aceptas un acabado algo menos pulido, establece fast_pretreatment: true para reducir el tiempo de preprocesamiento ^[1][6].

Cuando tengas los prompts y ajustes afinados, intégralos en un pipeline más amplio para elevar la calidad de producción.

Crear pipelines multimodelo con APIMart

Hailuo 02 rinde mejor junto a herramientas complementarias para el audio y las secuencias largas. Destaca creando B-roll visualmente dinámico, como agua, fuego o tela, pero no genera audio. Para cubrir ese hueco, combínalo en posproducción con herramientas de MiniMax Audio, como Speech 2.8 para locuciones o Music 2.6 para bandas sonoras ^[8]. Para proyectos de marca o comerciales, empieza generando un fotograma base con un modelo de imagen y pásalo a Hailuo 02 como first_frame_image para controlar con precisión la composición ^[7].

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

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

Incluso con prompts y pipelines bien afinados, pueden surgir problemas. Sigue estas buenas prácticas para resolverlos y optimizar las respuestas de la API.

Los dos fallos más habituales con Hailuo 02 son las combinaciones de resolución y duración no admitidas y las imágenes de entrada no válidas. Comprueba siempre que los ajustes de resolución y duración son compatibles ^[1][6]. Para las tareas de imagen a vídeo, la propia documentación de MiniMax recomienda una imagen de origen de menos de 20 MB, con el lado corto mayor de 300 px y una relación de aspecto entre 2:5 y 5:2, en formato JPG, PNG o WebP ^[5].

Cuando una tarea falla, revisa siempre el campo error de la respuesta de la tarea. Incluye detalles que te ayudan a resolver el problema rápidamente. En producción, mantén un intervalo de consulta moderado y reintenta con backoff exponencial; así reduces las llamadas innecesarias a la API y mantienes tu flujo de trabajo ágil.

Conclusión: puntos clave

Este es un resumen rápido de lo que hace de MiniMax Hailuo 02 una herramienta destacada para generar vídeo.

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

En APIMart, 768p cuesta $0,04 y 1080p $0,08 por segundo a octubre de 2026 ^[2], lo que lo convierte en una opción práctica tanto para producción profesional como para experimentación creativa.

Entre sus funciones destacadas:

• Herramientas de imagen a vídeo para un control preciso.
• Dirección de cámara desde el prompt (por ejemplo, «plano de seguimiento», «zoom in lento») para una cinematografía de aspecto profesional.
• Continuidad con el último fotograma, para transiciones fluidas en secuencias largas.

Ten en cuenta que, en APIMart, los clips en 1080p están limitados a 5 segundos (el anuncio de MiniMax indica 6 segundos). Para vídeos más largos, 768p es una buena alternativa, con clips de 10 segundos a menor precio ^[1].

Con estas funciones, MiniMax Hailuo 02 está listo para llevar tu flujo 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 de 10 segundos por clip, y los clips de 10 segundos requieren 768p o 512p (1080p solo admite 5 segundos). Para vídeos más largos, genera varios clips de 10 segundos y encadénalos usando el último fotograma de cada uno como first_frame_image del siguiente.

Para un clip de texto a vídeo de 10 segundos, incluye estos parámetros en la petición:

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

Después de enviar la petición, consulta la tarea hasta que esté en completed y descarga el vídeo desde data.result.videos[0].url[0].

¿Qué hago si mi tarea falla?

Si la tarea de generación de vídeo no sale adelante, empieza revisando el estado HTTP y el objeto error de la respuesta para localizar el problema. Estos son los casos más comunes:

• 400: parámetros no válidos, como una combinación de resolución y duración no admitida.
• 401: problemas de autenticación con tu clave API.
• 402: saldo insuficiente en tu cuenta.
• 429: has alcanzado el límite de peticiones.

Ante errores de límite de peticiones (HTTP 429) o problemas del servidor (HTTP 5xx), aplica backoff exponencial, es decir, esperas cada vez más largas entre reintentos. Revisa también los parámetros de entrada y asegúrate de que tus prompts evitan contenido sensible para no provocar errores de validación.

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

Para mantener la coherencia de los personajes en MiniMax Hailuo 02, empieza cada clip con un first_frame_image nítido y bien iluminado del personaje, y reutiliza el último fotograma de un clip como primer fotograma del siguiente. Si trabajas con varios clips, incluye detalles de iluminación coincidentes en los prompts. Para un flujo visual más suave, alinea los ángulos de cámara entre planos y considera transiciones sutiles como fundidos encadenados o cortes por coincidencia en posproducción. Estas técnicas ayudan a crear una narrativa coherente y pulida.