Guía de la API del generador de vídeo Hailuo 03

Si buscas la versión corta: puedes acceder hoy a Hailuo 03, un modelo de IA para vídeos cortos, mediante APIMart con una sola clave de API, tareas asíncronas y facturación por uso en dólares estadounidenses.

Por lo que puedo confirmar en este artículo, Hailuo 03 admite texto a vídeo, imagen a vídeo, flujos con fotogramas inicial y final, entradas de referencia de sujeto y prompts de cámara de Director Mode, como [Pan left] y [Zoom in]. El flujo de la API es sencillo: envía una tarea, consulta su estado o espera un webhook y, después, descarga el archivo terminado. Los precios se muestran por nivel de salida, con opciones de 512p, 768p y 1080p, aunque algunos límites —como la duración exacta del clip según la resolución— todavía no están definidos.

Si revisara esta página en busca de respuestas, esto es lo que querría saber desde el principio:

• Nombre del modelo: MiniMax-Hailuo-03
• Vía de acceso: API unificada de APIMart
• Tipos de entrada principales: prompt de texto, imagen fija y fotogramas de anclaje
• Casos de uso principales: anuncios para redes sociales, clips de producto, recorridos por aplicaciones y vídeos explicativos
• Patrón principal de la API: crear tarea → comprobar estado → obtener vídeo
• Riesgo principal: algunas especificaciones siguen cambiando, por lo que conviene verificar la documentación actual antes de desarrollar en torno a campos para casos límite

En pocas palabras: ya puedes probar Hailuo 03, pero lo trataría como una herramienta de producción de clips cortos, no como un sistema de vídeo completo. Para la mayoría de los equipos, la configuración más segura consiste en empezar con model, prompt, duration, resolution y first_frame_image, y añadir funciones adicionales más adelante, cuando la API se estabilice.

Destacan algunos datos:

• El artículo señala 3 niveles de resolución disponibles
• El flujo asíncrono tiene 3 pasos
• Los principales errores HTTP documentados incluyen 401, 402, 429 y 5xx
• Las relaciones de aspecto sugeridas incluyen 9:16 para contenido social corto y 16:9 para web, YouTube y anuncios pre-roll

Lo resumiría así: Hailuo 03 parece especialmente adecuado para tareas de vídeo repetibles y basadas en prompts cuando se necesitan resultados cortos, procesamiento por lotes y un flujo de API limpio. El resto del artículo explica dónde encaja, qué está confirmado hoy y cómo conectarlo con tu aplicación.

Tutorial de la API de Minimax Hailuo: clonación de voz, vídeo y música con IA y automatización con Make.com

Qué es Hailuo 03 y qué funciones de vídeo incluye

Hailuo 03 es el modelo de vídeo más reciente de MiniMax que aparece en la documentación de APIMart. Las especificaciones públicas siguen incompletas, por lo que conviene dividir la información en dos grupos: lo que está confirmado para la familia Hailuo y lo que todavía debe confirmarse específicamente para Hailuo 03. Por ahora, las funciones confirmadas de la familia Hailuo que se describen a continuación son la referencia más segura hasta que se publiquen todas las especificaciones de Hailuo 03.

Texto a vídeo, imagen a vídeo y controles de movimiento

La familia Hailuo admite generación de texto a vídeo e imagen a vídeo, además de animación basada en imágenes y control de los fotogramas inicial y final.^[1][3] Esto ofrece a los usuarios distintas formas de crear un clip según el material de partida: un prompt, una imagen fija o un par de fotogramas de anclaje.

Para el movimiento, Hailuo 2.3 incorporó instrucciones directas de cámara dentro de los prompts. Comandos como [Pan Right] y [Tilt Left] orientan el movimiento del plano durante la generación.^[4] Actualmente, esta es la función de control de movimiento mejor documentada de la línea Hailuo, por lo que constituye la referencia más útil para anticipar qué podría conservar Hailuo 03. Las especificaciones de Hailuo 03 para estos modos todavía no se han publicado por completo.

Este tipo de control resulta especialmente útil en anuncios, vídeos de producto y explicativos, donde el movimiento de cámara puede transformar el acabado del clip final.

Resolución, duración del clip, velocidad de fotogramas y calidad de salida

Hailuo 2.3 está documentado con resoluciones de 768p y 1080p, clips de 6 o 10 segundos según la resolución y una velocidad de 24 fps.^[1][2][3] APIMart también muestra niveles de precios para Hailuo 03 en 512p, 768p y 1080p. Sin embargo, los límites exactos de resolución, duración y salida de Hailuo 03 todavía no están confirmados, así que consulta la documentación vigente de la API antes de desarrollar en torno a esos ajustes.

Esto hace que Hailuo 03 sea especialmente relevante para vídeos cortos integrados en flujos de trabajo, donde los límites claros de duración, resolución y control de movimiento importan en el uso diario.

Dónde encaja Hailuo 03 en los flujos de trabajo de vídeo

Ahora que las funciones principales están claras, el siguiente paso es sencillo: ¿dónde encaja Hailuo 03 en un flujo de producción real?

Mientras que MiniMax-Hailuo-02 estableció la base de una generación de alta calidad, Hailuo 03 es más apropiado para producir vídeos cortos y repetibles. Piensa en anuncios sociales verticales, clips de demostración de productos, vídeos explicativos y recorridos por funciones de aplicaciones. Si la coherencia de marca o producto es importante, las entradas de referencia de sujeto pueden ayudar a mantener alineados el mismo producto, personaje o pantalla de interfaz en varios clips.

Anuncios cortos, vídeos de producto, clips sociales y explicativos

Usa texto a vídeo cuando partas de un prompt. Para quienes exploran modelos alternativos, Grok Imagine Video también ofrece sólidas capacidades de texto a vídeo. Usa imagen a vídeo cuando partas de una imagen fija.

En los anuncios cortos, el texto a vídeo permite estructurar los prompts en torno al producto, el gancho, la llamada a la acción y el tono de marca. A partir de ahí, Director Mode ayuda a definir el ritmo y la sensación del plano. En cuanto a las relaciones de aspecto, 9:16 se adapta mejor a TikTok, Instagram Reels y YouTube Shorts, mientras que 16:9 funciona mejor para YouTube, páginas de destino y anuncios pre-roll en CTV.^[7][8][9][6]

La tabla siguiente muestra qué configuración resulta más adecuada para cada caso de uso:

Aquí funciona bien un orden sencillo para el prompt: marca/producto, audiencia/canal, estilo, movimiento, CTA.

Por ejemplo:

Marca DTC de cuidado de la piel, sérum de vitamina C, dirigido a mujeres de 25–40 años en Instagram Reels, estética minimalista y luminosa, baño blanco, formato vertical 9:16, [Dolly in] hacia el frasco, terminar con un primer plano y el texto en pantalla: Piel luminosa en 7 días.^[5][6]

Esta estructura mantiene el prompt enfocado y facilita su reutilización en distintas campañas.

Automatización de varias escenas y flujos de contenido multimodal

Para los equipos que producen numerosos clips, Hailuo 03 también funciona bien en flujos encadenados. Como el modelo admite el envío asíncrono de tareas, los equipos pueden enviar una solicitud por escena, variante de producto o segmento de audiencia y recopilar los resultados a medida que termina cada una. Si una secuencia debe durar más que un solo clip, pasar el último fotograma de un clip terminado a la siguiente solicitud ayuda a mantener la continuidad visual entre escenas.^[10][11]

Un flujo repetible suele recorrer cuatro pasos:

• Entradas de prompts o imágenes estructuradas
• Envío asíncrono de tareas
• Recuperación de resultados y revisión de calidad
• Entrega a un CMS, una plataforma publicitaria o un editor de vídeo

Esta configuración convierte la generación de vídeo en un proceso de producción repetible, en lugar de una tarea aislada cada vez. Resulta aún más útil cuando Hailuo 03 se conecta a un flujo de API reutilizable.

Cómo acceder a Hailuo 03 mediante la API de APIMart

Puedes dirigir tareas de vídeo a Hailuo 03 con una sola clave de APIMart configurando model: "MiniMax-Hailuo-03". A partir de ahí, el flujo es bastante directo: crea una tarea, comprueba su estado y descarga el archivo terminado.

Configuración de la cuenta, claves de API, selección del modelo y fundamentos de precios

Empieza por crear una cuenta en APIMart, verificar tu correo electrónico y añadir los datos de facturación. Después, genera una clave de API desde el panel. Guarda esa clave en una variable de entorno y nunca la incluyas en el control de versiones. ^[18]

APIMart cobra por cada segundo de vídeo generado. Antes de ampliar el uso, consulta la tarifa vigente de Hailuo 03 en el panel de APIMart.

Cuando la clave esté lista, puedes pasar a la solicitud de generación asíncrona.

Patrón de solicitud de la API: crear una tarea, consultar el estado y recuperar el vídeo

Cada solicitud de generación de vídeo de Hailuo en APIMart sigue el mismo flujo asíncrono de tres pasos: enviar una tarea, consultar su estado y recuperar el archivo.

Envía una solicitud POST a https://api.apimart.ai/v1/videos/generations con estos encabezados en cada petición: Authorization: Bearer YOUR_API_KEY y Content-Type: application/json. ^[19][20][21] Un payload básico de Hailuo 03 tiene este aspecto:

{
  "model": "MiniMax-Hailuo-03",
  "prompt": "Cinematic 5-second shot of a running shoe on a rotating pedestal, dynamic lighting, 1080p, product-focused [Pan left]",
  "duration": 5,
  "resolution": "1080p",
  "first_frame_image": "https://cdn.apimart.ai/blog/hailuo-03-ai-video-generator-everything-we-know-access-api-cover.webp"
}

Si generas a partir de una imagen, first_frame_image puede ser una URL pública o una cadena Base64. La respuesta de la API incluye un task_id. A partir de ahí, el servicio consulta el endpoint de estado hasta que la tarea pasa de queued a processing y, después, a succeeded o failed.

Cuando el vídeo esté listo, descárgalo y muévelo a un almacenamiento persistente como S3 utilizando tu propio esquema de nombres de archivo. Registra el task_id, el nombre del modelo y las marcas de tiempo de cada tarea. Este pequeño hábito facilita mucho la depuración posterior de retrasos o problemas de gasto. ^[21][22][23]

También puedes usar callback_url para recibir actualizaciones mediante webhooks en lugar de consultar el estado sin pausa. Esto reduce las solicitudes adicionales y simplifica la gestión del estado de las tareas. ^[16][17]

La gestión de errores es bastante clara:

• 401 indica que la clave de API es incorrecta o que el formato del token Bearer no es válido
• 402 indica que debes recargar tu saldo de crédito en USD
• 429 indica que has alcanzado un límite de solicitudes y debes aplicar retroceso exponencial
• 5xx indica que primero debes comprobar el estado de la tarea y luego reintentar con retroceso

Escenarios de integración de la API para desarrolladores y empresas

Una vez conectado el flujo de solicitudes, Hailuo 03 encaja fácilmente en procesos de contenido automatizados. Por ejemplo, un equipo de comercio electrónico puede recorrer un catálogo de productos, enviar una solicitud de imagen a vídeo por cada SKU con la misma plantilla de prompt y recopilar clips giratorios de producto de 5 segundos a medida que terminan las tareas.

Una plataforma de marketing puede crear versiones localizadas de anuncios cambiando el idioma del prompt y la relación de aspecto, como 9:16 o 16:9, en campañas en inglés y español sin modificar el resto del flujo. ^{[12][13][14][15]} Además, los productos SaaS pueden integrar la generación de vídeo directamente en su interfaz, enviar tareas desde el servidor y mostrar al usuario la URL del resultado en cuanto llegue el webhook.

APIMart utiliza un único patrón de endpoint, por lo que Hailuo 03 mantiene la coherencia con el resto de la gama Hailuo: el mismo estilo de autenticación, el mismo flujo asíncrono y los mismos códigos de error. Para Hailuo 03, los campos más seguros sobre los que desarrollar al principio son model, prompt, duration, resolution y first_frame_image.

Campos como last_frame_image, audio_sync y subject_reference aparecen en la documentación actual, pero podrían cambiar mientras se termina de definir la superficie de la API. Por eso, es más prudente añadirlos después, cuando se estabilicen. Así, la integración queda preparada para anuncios, clips de producto y flujos de contenido automatizados sin asumir riesgos adicionales relacionados con las especificaciones.

Conclusión: qué ofrece hoy Hailuo 03 y cómo prepararse

Hailuo 03 se entiende mejor como un modelo de vídeo guiado por prompts para clips cortos y controlados. Según la documentación actual, sigue siendo una herramienta para clips breves. En pocas palabras, esto significa que es una opción en una etapa temprana, no un motor de producción completo.

Ahí es donde mejor encaja: flujos cortos y repetibles en los que se buscan pruebas rápidas y un control preciso. Hailuo 03 funciona bien para experimentos multimodales breves, avances para redes sociales y clips de producto de imagen a vídeo.

Si esto coincide con la forma de trabajar de tu equipo, APIMart simplifica las pruebas. Obtienes acceso inmediato a la API con una sola clave y un flujo asíncrono, lo que facilita probar Hailuo 03 sin demasiada configuración.

Lo más sensato es empezar poco a poco, comprobar la calidad del resultado y ampliar el uso solo cuando el patrón de prompts sea estable. Un enfoque sencillo sería:

• Usar borradores de Fast Mode para validar los prompts
• Crear primero un único flujo piloto
• Utilizar colas o procesos de trabajo para mantener la capacidad de respuesta de la aplicación

Los equipos que más aprovechen Hailuo 03 tratarán los prompts como guiones, harán pruebas rápidas y mantendrán preparado un flujo alternativo.

Preguntas frecuentes

¿Hailuo 03 ya está listo para producción?

Sí. Hailuo 03 está listo para su uso en producción. Incluye una API asíncrona para los equipos que necesitan ejecutar tareas a escala, además de un SLA de disponibilidad del 99.9%.

En entornos de producción, los equipos deberían:

• Configurar una URL de callback para recibir automáticamente las actualizaciones del estado de las tareas
• Usar retroceso exponencial para errores 429 y 5xx
• Descargar los archivos generados en cuanto estén listos, porque las URL de los recursos caducan después de 24 horas

¿Qué entradas puedo usar con Hailuo 03?

Hailuo 03 admite entradas de texto e imagen para generar vídeo. Los cuatro modos principales son texto a vídeo, imagen a vídeo, generación con fotogramas inicial y final y vídeo con referencia de sujeto.

Para la generación basada en imágenes, sube primero el archivo y después pasa la URL devuelta como first_frame_image. Las imágenes deben ocupar menos de 20 MB y tener una relación de aspecto de entre 2:5 y 5:2. También puedes añadir al prompt comandos de cámara entre corchetes, como [Pan left].

¿Cómo funcionan los webhooks para las tareas de vídeo?

Como la generación de vídeo se ejecuta de forma asíncrona, los webhooks envían actualizaciones automáticas del estado de la tarea para que no tengas que consultar manualmente la API. Solo tienes que incluir una callback_url en la primera solicitud de generación.

Cuando termina el renderizado o se produce un error, el sistema envía una solicitud POST a esa URL. Tu servidor debe recibirla y confirmar la recepción en un plazo de 3 segundos para que el webhook funcione según lo previsto.