MiniMax

Hailuo 2.3

hailuo-2.3/image-to-video

Modelo de generación de video lanzado por MiniMax, que admite tanto la generación de video a partir de texto como a partir de imágenes; mejora respecto a la generación anterior en la estabilidad del estilo anime, la renderización de movimientos de cuerpo completo y el realismo de las microexpresiones faciales, ideal para la creación de cortometrajes de anime y piezas comerciales con textura realista

hailuo-2.3-fast/image-to-video hailuo-2.3/image-to-video hailuo-2.3/text-to-video

Probar hailuo-2.3/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

hailuo-2.3/image-to-video per video

Especificaciones	Precio unitario
6S	$0.400
10S	$0.800

Presentación general

hailuo-2.3/image-to-video es el modelo de imagen a vídeo de la serie MiniMax Hailuo 2.3 que genera vídeos a partir de una única imagen del primer fotograma, invocado a través de la interfaz unificada de HiAPI.ai. Destaca en la representación del movimiento de personas y las microexpresiones faciales, y mantiene una buena estabilidad en imágenes estilizadas como el anime y en escenas de acción de cuerpo completo, lo que lo hace adecuado para desarrolladores y equipos creativos que necesitan extender rápidamente material estático a vídeos cortos. Admite vídeos finales de 6 o 10 segundos y permite activar la optimización automática de prompts según sea necesario.

Puntos clave

Fija el punto de partida de la imagen con una sola imagen del primer fotograma: basta con proporcionar una imagen del primer fotograma junto con una descripción de texto para generar un vídeo dinámico que continúe esa composición y estilo.
Movimientos de personas y detalles faciales más naturales: orientado a escenas de personas en primer plano y de acciones complejas de cuerpo completo, se refuerzan la fluidez del movimiento y el realismo de las microexpresiones.
Mayor estabilidad en vídeos finales estilizados y comerciales: mantiene una buena coherencia en imágenes de estilos especiales como el anime y en imágenes de promoción de productos, lo que facilita su integración directa en el flujo de trabajo.

Descripción de capacidades

Generación de vídeo a partir de una sola imagen: introduce una imagen del primer fotograma en formato jpeg, png o webp junto con un prompt para generar un vídeo, sin necesidad de material de varios fotogramas, ideal para extender rápidamente recursos de imagen existentes.

Dos opciones de duración: la duración del vídeo final puede especificarse entre 6 y 10 segundos, con 6 segundos por defecto, lo que facilita planificar la producción según el formato de publicación o la longitud del guion gráfico.

Optimización automática de prompts: prompt_optimizer está activado por defecto, y el modelo completa y optimiza automáticamente la descripción, lo que reduce el coste de ajuste de los prompts; también puede desactivarse para conservar la intención original.

Control del contenido de la imagen mediante descripción de texto: el prompt admite hasta 2000 caracteres y se utiliza para describir la acción, el plano y la atmósfera deseados, y junto con la imagen del primer fotograma condiciona la evolución general de la imagen.

Escenarios de aplicación

Cortometrajes de estilo anime para creadores de contenido: a partir de ilustraciones de personajes o guiones gráficos, se generan recursos de vídeo corto con un estilo coherente para la publicación y edición de contenido de anime.
Recursos de animación para publicidad y promoción de productos: introduce imágenes de productos y descripciones de escenas para generar vídeos cortos de exhibición de productos, destinados a páginas de detalle de comercio electrónico y anuncios en el feed.
Dinamización de recursos de interpretación con personas: utiliza fotos de caracterización o fotogramas de rodaje de personas para generar clips con movimientos de cuerpo completo y expresiones faciales, destinados a microdramas, bailes y contenido para redes sociales.
Visualización rápida de guiones creativos: realiza pruebas de rodaje a ritmo acelerado con imágenes conceptuales para validar ideas de planos y movimientos a bajo coste, y utilizarlas en la revisión creativa y la confirmación de propuestas.

Limitaciones y recomendaciones de selección

Solo admite la generación a partir de una única imagen del primer fotograma, no ofrece control del fotograma final y no permite restringir con precisión el punto final de la imagen; el resultado generado tiene una duración fija de 6 o 10 segundos, por lo que, si se necesita una organización temporal más precisa, debe gestionarse en la fase de edición. Es adecuado para cortometrajes de interpretación con personas, imágenes estilizadas y productos comerciales; si se necesita concebir la imagen desde cero solo con texto, debe utilizarse la línea de texto a vídeo de la misma serie; si se busca una iteración por lotes más rápida, puede considerarse la versión de la serie centrada en la velocidad y el coste.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo disponible: hailuo-2.3-fast/image-to-video Nov 3, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Hailuo 2.3 Image to Video requiere subir una imagen?

Sí. Actualmente, hailuo-2.3/image-to-video es una ruta de imagen a video: la imagen de entrada define el sujeto y la composición inicial, y el Prompt define el movimiento, el encuadre y los cambios del entorno.
¿Qué duraciones y resoluciones admite Hailuo 2.3 Image to Video?

El contrato de solicitud actual de HiAPI admite 6s / 10s. Los valores disponibles están sujetos al panel de parámetros de la página y a la documentación de la API.
¿Cómo se cobra Hailuo 2.3 Image to Video?

La tarea se cobra por video según el tramo de duración seleccionado. La página muestra el precio en tiempo real con la unidad monetaria global, y el cargo final se basa en el registro de la tarea completada con éxito.
¿Cómo mejorar la estabilidad del sujeto en la generación de video a partir de imágenes?

Utiliza una imagen de entrada con un sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describe primero la acción principal y el plano de cámara, y luego enumera la apariencia, los materiales y la relación con el fondo que deben conservarse. Para la primera prueba, se recomienda usar una duración más corta.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: hailuo-2.3/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para hailuo-2.3/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 2000

Texto de indicación que describe el contenido del vídeo que se va a generar.

durationstringOpcionalPredeterminado: "6"

Duración del vídeo generado, en segundos; por defecto, 6 segundos.

Opciones:610

image_urlstringObligatorio

URL de la imagen del primer fotograma; solo se admite una única imagen. Los formatos compatibles son jpeg, png y webp; no se admite SVG.

prompt_optimizerbooleanOpcionalPredeterminado: true

Indica si se optimiza automáticamente la indicación para obtener un mejor resultado de generación; por defecto, true.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-2.3/image-to-video",
  "input": {
    "prompt": "…",
    "duration": "6",
    "image_url": "…",
    "prompt_optimizer": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "hailuo-2.3/image-to-video",
    input: {
      "prompt": "…",
      "duration": "6",
      "image_url": "…",
      "prompt_optimizer": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "hailuo-2.3/image-to-video",
        "input": {
          "prompt": "…",
          "duration": "6",
          "image_url": "…",
          "prompt_optimizer": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}