MiniMax

MiniMax H3

minimax-h3

Modelo de video multimodal unificado que procesa texto, imágenes, video y audio en un mismo contexto, admite generación de video a partir de texto, de imágenes y de referencias, edición mediante instrucciones y puede generar audio sincronizado

minimax-h3 minimax-h3-max/image-to-video minimax-h3-max/text-to-video

Probar minimax-h3

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

minimax-h3 per second

Precio unitario	$0.1189

Descripción general

MiniMax H3 es un modelo de generación de video de propósito general lanzado por MiniMax que procesa de forma simultánea texto, imágenes, video y audio en un contexto unificado. Admite generación de video a partir de texto, generación de video a partir de imagen, control del primer y último fotograma, generación de video con referencias multimodales y puede producir imágenes nativas en 2K. Se invoca a través de la interfaz unificada de HiAPI.ai, lo que lo hace adecuado para desarrolladores que necesitan completar con un solo modelo el prototipado de storyboards, la animación de materiales y cortometrajes con consistencia de estilo de personaje, y especialmente para equipos que buscan cubrir varios modos de generación dentro de un flujo de trabajo unificado.

Aspectos destacados

Contexto unificado para entradas multimodales: dentro del mismo modelo se pueden combinar referencias de texto, imagen, video y audio, lo que reduce el costo de cambiar entre modelos especializados para distintas tareas.
Salida nativa en 2K: actualmente genera únicamente en resolución nativa 2K, con relaciones de aspecto que abarcan desde 21:9 hasta 9:16 y adaptativa, cubriendo las necesidades de distribución horizontal y vertical.
Control de transición mediante primer y último fotograma: basta con proporcionar las imágenes del primer y del último fotograma para controlar la transición entre ambas, lo que facilita crear transiciones y tomas de comparación antes/después.
Referencias multimodales para mantener la consistencia: admite hasta 5 imágenes de referencia, 3 videos de referencia y 3 audios de referencia, utilizados para mantener personajes, estilos y ritmo.

Descripción de capacidades

Texto a video: basta con introducir un prompt de texto para generar videos de 4 a 15 segundos en duración entera; la relación de aspecto puede ser 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 o adaptativa, con 16:9 por defecto.

Imagen a video y control del primer y último fotograma: se genera un video a partir de una imagen pública como primer fotograma, o bien se proporcionan simultáneamente el primer y el último fotograma para controlar la transición; el control de fotogramas y los campos de medios de referencia son mutuamente excluyentes, por lo que la ruta debe definirse de antemano al seleccionar la configuración.

Generación de video con referencias multimodales: acepta hasta 5 imágenes de referencia, 3 videos de referencia de 2 a 15 segundos y hasta 3 audios de referencia con una duración total no superior a 15 segundos; el audio no puede usarse de forma aislada y debe acompañarse de al menos una imagen o un video.

Marca de agua AIGC opcional: el parámetro watermark determina si el video de salida lleva marca de agua AIGC; por defecto no se añade, lo que facilita alternar según los requisitos de cumplimiento de cada canal de publicación.

Escenarios de aplicación

Equipos de publicidad que crean prototipos de storyboard rápidamente con prompts de texto: generan clips de 4 a 15 segundos con prompts de múltiples tomas, que se usan como material de previsualización de storyboard para revisiones creativas y propuestas a clientes.
Diseño de e-commerce que anima imágenes de producto en clips: generan videos en 2K usando una imagen de producto o ilustración como primer fotograma, directamente para páginas de detalle de producto y materiales de distribución en feeds.
Creadores de contenido que elaboran transiciones con primer y último fotograma: controlan la transición a partir de dos imágenes (antes y después) y producen tomas de transición para edición de videos cortos o demostraciones de comparación antes/después.
Generación con referencias multimodales para cortometrajes con personajes consistentes: combinan imágenes de personaje, videos de estilo y audios de referencia para generar clips con estilo uniforme, destinados a la producción masiva de contenido seriado.

Limitaciones y recomendaciones de selección

La duración máxima por generación es de 15 segundos; para contenido más largo es necesario generar por segmentos y luego unirlos. El control del primer y último fotograma no puede combinarse con los campos de medios de referencia, y el modo de referencia requiere organizar las entradas de imagen, video y audio según las reglas, lo que supone cierta dificultad en la elaboración del prompt; el audio de referencia no puede usarse de forma aislada. Si la tarea requiere tomas continuas de más de 15 segundos, niveles de resolución inferiores a 2K o un flujo de generación puramente textual más sencillo, conviene evaluar otras rutas o modelos.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo: minimax-h3 — genera video nativo en 2K mediante POST /v1/tasks, compatible con texto a video de 4-15 segundos… Jul 31, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué tipo de modelo de video es MiniMax H3?

Se centra en el Prompt y también puede incluir fotogramas inicial y final o imágenes, videos y audios de referencia; los distintos modos de control deben combinarse según el contrato de parámetros vigente.
¿Qué especificaciones de salida admite MiniMax H3?

Admite de 4 a 15 segundos, resoluciones que incluyen 2K y relaciones de aspecto que incluyen 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 y adaptive.
¿Se puede generar voz o usar referencias de audio?

Referencias opcionales de imagen, vídeo y audio; compatible con la generación de audio
¿Cómo se factura MiniMax H3?

Se factura según la duración de salida y el nivel en tiempo real; las diferencias causadas por la resolución, el modo o las opciones de sonido se rigen por el precio de la página y el registro de la tarea.

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: minimax-h3

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para minimax-h3 y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 7000

Prompt del contenido del video, obligatorio en todos los modos de generación, longitud máxima de 7000 caracteres.

durationintegerOpcionalPredeterminado: 5min 4max 15

Duración del video generado, en segundos enteros, por defecto 5 segundos.

watermarkbooleanOpcionalPredeterminado: false

Indica si se añade una marca de agua AIGC al video generado, valor booleano, por defecto false.

audio_urlsarrayOpcionalmaxItems 3

Array de URLs de audio de referencia, hasta tres fragmentos y una duración total no superior a 15 segundos; el audio no puede usarse solo, debe combinarse al menos con una imagen de referencia o un video de referencia.

Array [ string ]

image_urlsarrayOpcionalmaxItems 5

Array de URLs de imágenes de referencia para la generación de video con referencias multimodales; HiAPI acepta como máximo cinco imágenes; no puede usarse junto con el control de primer y último fotograma.

Array [ string ]

resolutionstringOpcionalPredeterminado: "2K"

Resolución de salida; MiniMax H3 actualmente solo admite generación nativa en 2K, por defecto 2K.

Opciones:2K

video_urlsarrayOpcionalmaxItems 3

Array de URLs de videos de referencia para la generación de video con referencias multimodales, hasta tres fragmentos, cada uno de 2 a 15 segundos y una duración total no superior a 15 segundos.

Array [ string ]

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto de la imagen de salida, por defecto 16:9; la generación de video a partir de texto usa 16:9 por defecto, la guía por primer y último fotograma sigue la imagen de entrada, y el modo de referencia puede adoptar un valor adaptativo.

Opciones:21:916:94:31:13:49:16adaptive

last_frame_imagestringOpcional

URL de imagen pública usada como fotograma final; debe proporcionarse junto con first_frame_image.

first_frame_imagestringOpcional

URL de imagen pública usada como primer fotograma; el control de primer y último fotograma no puede usarse junto con los campos de medios de referencia, y es obligatorio cuando se proporciona last_frame_image.

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": "minimax-h3",
  "input": {
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }
}'

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: "minimax-h3",
    input: {
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "2K",
      "aspect_ratio": "16:9"
    }
  }),
});
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": "minimax-h3",
        "input": {
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "2K",
          "aspect_ratio": "16:9"
        }
    },
)
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"
    }
  }
}