Introducción
MiniMax lanzó Hailuo 2.3 el 28 de octubre de 2025 como el siguiente paso después de Hailuo 02, junto con una variante más ligera, Hailuo 2.3 Fast. Este endpoint ofrece ambos como imagen a video: subes la imagen con la que debe empezar la toma, describes lo que sigue y recibes un MP4 sin sonido. El campo generation_mode elige entre el modelo completo y la variante Fast sin cambiar nada más de la solicitud.
Funciones y aspectos destacados
Movimiento que se ve físico
MiniMax construyó 2.3 en torno a un movimiento corporal fluido, una respuesta más estable a los movimientos de cámara y luces y sombras más convincentes. En nuestra prueba en 1080p, el vestido de seda rojo de una bailarina siguió meciéndose después del giro, y el ruedo se asentó en lugar de congelarse.
Rostros que cambian poco a poco
Las microexpresiones son el otro eje de esta versión. Un clip que empieza con una expresión neutra puede pasar por una mirada, un respiro y una sonrisa en seis segundos; nuestra prueba en la ventana con lluvia muestra una sonrisa que crece mientras la cámara se acerca.
Dos modelos, una misma solicitud
standard y fast aceptan la misma imagen, prompt, resolución y duración, así que puedes bocetar una toma en Fast y volver a renderizar el prompt elegido en standard sin reescribir nada. La salida sigue las proporciones de la imagen inicial: una imagen 16:9 regresó en 1364 × 768 a 24 cuadros por segundo.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe la acción después de la imagen inicial y el movimiento de cámara, hasta 5000 caracteres. Hailuo 2.3 no tiene sonido, así que el diálogo no se pronuncia. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | Sí | Imagen inicial obligatoria en JPEG, PNG o WebP de hasta 10 MB. El clip conserva sus proporciones. |
generation_mode | No | standard (predeterminado) usa Hailuo 2.3; fast usa Hailuo 2.3 Fast, que termina antes y cuesta menos por clip. |
resolution | No | 768p (predeterminado) o 1080p. 1080p cuesta más y solo viene en clips de 6 segundos. |
duration_seconds | No | 6 (predeterminado) o 10 segundos. 10 segundos requieren 768p y cuestan más por clip. |
Precios
Se cobra por clip según el modo (standard o fast), la resolución y la duración; las solicitudes que MiniMax rechaza o que fallan no se cobran.
| Especificación | Precio |
|---|---|
| $0.163 / solicitud |
| $0.256 / solicitud |
Casos de uso
Arte clave en movimiento
Imágenes de campaña, portadas y fotos de póster ganan una versión animada corta para redes y adelantos. Ilumina la imagen como debe verse el primer segundo del clip, porque el modelo arranca exactamente ahí.
Baile, moda y tela
Giros, pasos y prendas que se mueven alrededor del cuerpo son el material más fuerte para este modelo. Empieza desde una imagen ya en movimiento y di cómo termina el gesto, para que el clip tenga un punto de llegada.
Series de borradores
Cuando necesites muchas variantes de una toma, renderízalas en Fast a 768p, compáralas y reserva el modo standard o el 1080p para la versión que sale publicada.
Guía de prompts y consejos prácticos
Una acción y luego la cámara
Escribe el prompt como una descripción breve de toma: quién se mueve, qué pasa, cómo termina y qué hace la cámara. Por ejemplo, la mujer se aparta de la ventana, se acomoda el cabello detrás de la oreja y sonríe mientras la cámara se acerca. Varias acciones sin relación en seis segundos tienden a mezclarse.
Respeta la imagen que subiste
La imagen inicial fija el vestuario, la luz y la composición. Describe cambios que puedan nacer de ella, como un giro, un paso o una ráfaga de viento, en lugar de pedir ropa nueva o un lugar que la primera imagen no muestra.
Planea duración y tamaño juntos
Los clips de 10 segundos solo existen en 768p y el 1080p dura 6 segundos. Mantén las solicitudes sugerentes en lugar de explícitas: MiniMax revisa prompts y clips terminados, la redacción explícita se rechaza de inmediato y las escenas que derivan hacia contenido más revelador pueden fallar tras varios minutos. Ninguna de esas solicitudes se cobra.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/hailuo-2.3/image-to-video",
"input": {
"duration_seconds": 6,
"generation_mode": "standard",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.























