MiniMax

Hailuo 2.3

hailuo-2.3-fast/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-fast/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-fast/image-to-video per video

Especificaciones	Precio unitario
6S	$0.270
10S	$0.460

Descripción general

Hailuo 2.3-Fast es la versión rápida de la serie MiniMax Hailuo 2.3 orientada a la generación de vídeo a partir de imagen. Recibe una imagen de primer fotograma y un mensaje de texto, y genera un vídeo de 6 o 10 segundos, con énfasis en la naturalidad de los movimientos corporales y las microexpresiones faciales de los personajes, así como en la estabilidad de la salida en estilos visuales como el anime. Es adecuada para desarrolladores que necesitan hacer pruebas rápidas, iterar guiones gráficos o producir material de vídeo corto a partir de una sola imagen, y puede integrarse mediante la interfaz unificada de HiAPI.ai.

Puntos clave

Versión ligera y rápida para vídeo a partir de imagen: la misma serie cuenta con una versión completa y un modelo de texto a vídeo; Fast se centra en la eficiencia de producción impulsada por una sola imagen, ideal para pruebas rápidas e iteración en fases tempranas.
Movimiento impulsado directamente por la imagen de primer fotograma: basta con proporcionar una imagen de primer fotograma en jpeg, png o webp y un mensaje de texto para generar una secuencia de movimiento continuo.
Optimización automática del mensaje de texto opcional: prompt_optimizer está activado por defecto y permite mejorar los resultados de generación sin reescribir el mensaje de texto.
Dos duraciones: 6 y 10 segundos: cambiar la duración permite equilibrar la longitud del material y el coste de generación, cubriendo necesidades de vídeo corto y borradores de guion gráfico.

Descripción de capacidades

Generación de vídeo a partir de una sola imagen de primer fotograma: se introduce una imagen de primer fotograma y una descripción de texto, y se devuelve un vídeo en movimiento, convirtiendo material estático directamente en un recurso audiovisual reproducible.

Control de la imagen mediante mensaje de texto: el campo prompt admite descripciones de hasta 2000 caracteres, que se utilizan para especificar acciones, plano y contenido visual, controlando la dirección de la generación.

Duración seleccionable: duration ofrece dos opciones, 6 y 10 segundos, para que los desarrolladores elijan la longitud del vídeo final según la plataforma de publicación o la estructura del guion gráfico.

Optimización automática del mensaje de texto: prompt_optimizer está activado por defecto y permite completar y reescribir automáticamente el mensaje de texto, reduciendo el coste de prueba y error por ajustes repetidos de parámetros.

Casos de uso

Creadores de contenido de anime y estilizado: imagen de personaje + mensaje de animación: convertir ilustraciones o diseños de personaje en clips de vídeo corto con movimiento, para cortometrajes de estilo anime, contenido en redes sociales o carteles animados.
Equipos de vídeo corto: imagen de personaje + descripción de actuación: generar a partir del primer fotograma de un personaje clips con baile, movimiento corporal o expresiones faciales, como material final o borrador de guion gráfico.
Productos y publicidad comercial: imagen de producto + guion de presentación: convertir imágenes fijas de productos en vídeos de presentación dinámica, para generar rápidamente material para páginas de detalle de comercio electrónico, anuncios en flujos de información o vídeos promocionales.
Equipos creativos: pruebas de visualización de guiones: generar rápidamente clips de 6 o 10 segundos con una sola imagen para validar la dirección creativa y decidir después si se pasa a la producción formal.

Limitaciones y recomendaciones de selección

Solo admite la generación a partir de una única imagen de primer fotograma y no permite controlar el primer y último fotograma; la imagen de entrada debe ser jpeg, png o webp, y no se admite SVG. La versión Fast solo hace vídeo a partir de imagen y no tiene ruta de texto a vídeo; si se necesita generar vídeo solo a partir de texto o la calidad de la versión completa, debe recurrirse al modelo text-to-video o a la versión completa de image-to-video de la misma serie. La resolución y la velocidad de generación carecen de parámetros oficiales que las respalden, por lo que se recomienda realizar primero una prueba en lotes pequeños antes de decidir.

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-fast/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 2000

Descripción textual para la generación de video, que indica el contenido de la escena que se desea generar. Toma un valor de cadena.

durationstringOpcionalPredeterminado: "6"

Duración del video generado, en segundos. Toma un valor numérico en forma de cadena; por defecto 6.

Opciones:610

image_urlstringObligatorio

URL de la imagen del primer fotograma; solo admite una única imagen en formato jpeg/png/webp; no admite SVG. Toma un valor de cadena.

prompt_optimizerbooleanOpcionalPredeterminado: true

Indica si se optimiza automáticamente el prompt para obtener un mejor resultado de generación. Toma un valor booleano; 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-fast/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-fast/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-fast/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"
    }
  }
}