MiniMax

MiniMax H3 Max Turbo

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

Modelo de video con optimización de velocidad de MiniMax, compatible con texto a video y imagen a video (permite especificar el primer fotograma y un fotograma final opcional), genera clips de 1 a 15 segundos en 480P a 1080P por vez, ideal para la producción rápida de videos cortos de marketing y la previsualización de storyboards

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

Probar minimax-h3-max-turbo/text-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

minimax-h3-max-turbo/text-to-video per second

Especificaciones	Precio unitario
480P	$0.025
768P	$0.040
1080P	$0.080

Descripción general

Este es un modelo de texto a video que recibe una descripción textual y genera directamente un clip de video. En una sola generación puede crear imágenes de 1 a 15 segundos, con tres opciones de resolución: 480P, 768P y 1080P, y admite seis relaciones de aspecto: 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. El prompt puede tener hasta 50000 caracteres y también se puede especificar una semilla aleatoria para reproducir el resultado. Es adecuado para escenarios que requieren generar imágenes en movimiento desde cero, como la producción rápida por lotes de videos cortos de marketing, la previsualización de storyboards y la creación de contenido para redes sociales.

Puntos clave

Video directo desde texto de hasta 15 segundos: la duración se puede ajustar entre 1 y 15 segundos; el video final puede ser hasta aproximadamente 0,7 segundos más largo que lo solicitado, ideal para clips cortos independientes.
Tres resoluciones y seis relaciones de aspecto: elige 480P, 768P o 1080P según sea necesario; las seis relaciones cubren escenarios de publicación habituales, tanto en horizontal como en vertical.
Intensidad ajustable de la expansión de prompt: disabled omite la reescritura, balanced responde en aproximadamente un segundo y quality tarda hasta unos 30 segundos para generar prompts más ricos.

Descripción de capacidades

Generación de video a partir de descripción textual: basta con introducir un prompt de texto para producir un clip de video; el prompt admite hasta 50000 caracteres y es adecuado para escenarios sin material existente en los que se necesita construir la imagen desde cero.

Duración y resolución seleccionables: en cada solicitud se elige una duración de 1 a 15 segundos y una resolución entre 480P, 768P y 1080P, equilibrando detalle y especificaciones según el uso.

Seis relaciones de aspecto: se puede emitir en 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16, adaptándose a diferentes ubicaciones como reproducción horizontal, feeds cuadrados y videos cortos verticales.

Control de semilla y expansión de prompt: se puede especificar una semilla aleatoria para fijar el punto de partida de la generación; la expansión de prompt admite tres modos (desactivado, equilibrado y alta calidad), para elegir según el ritmo de generación.

Escenarios de uso

Equipos de marketing que producen rápidamente varias versiones de videos cortos: introduce descripciones textuales de los argumentos de venta del producto o del tema de la campaña y genera por lotes varios clips candidatos para comparar materiales antes de publicarlos en redes sociales.
Creación de contenido vertical por creadores sociales: describe el contenido visual con relación 9:16 y duración corta para obtener clips listos para publicar en plataformas de video corto.
Previsualización dinámica de storyboards en la fase previa audiovisual: genera bocetos dinámicos a partir del texto del guion gráfico para ayudar al director y al equipo de arte a confirmar el ritmo de los planos y la composición antes de la producción formal.
Validación de conceptos creativos publicitarios: describe el concepto creativo con texto conciso y genera rápidamente un video de corta duración para mostrar al cliente la dirección dinámica, no el resultado final.

Limitaciones y recomendaciones de selección

La duración va de 1 a 15 segundos; el video final puede ser hasta aproximadamente 0,7 segundos más largo que lo solicitado; 1080P es un refinamiento latente a partir de la fuente nativa de 768P, no una generación nativa. El prompt admite hasta 50000 caracteres. El modelo solo admite texto a video; no puede usar imágenes, clips ni audio de referencia para mantener la coherencia de personajes y estilo, ni dispone de capacidades de edición de video.

Novedades

Ver el registro de cambios →

Nuevo modelo MiniMax H3 Max Turbo disponible: texto a video e imagen a video con primer y último fotograma Nov 12, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿El 1080P de este modelo se genera de forma nativa?

No es una generación nativa; el 1080P se obtiene mediante un refinamiento en el espacio latente a partir de una fuente de 768P; el nivel más alto que el modelo genera de forma nativa es 768P. Si tienes requisitos estrictos sobre el detalle de la imagen, se recomienda evaluar según la generación nativa en 768P, o cambiar a un nivel que admita máster en 2K.
¿Se puede usar una imagen de referencia para fijar el personaje en la generación de video a partir de imágenes?

Actualmente no se admite la generación de video a partir de imágenes de referencia. image_url solo se usa como fotograma inicial; el lienzo de generación seguirá esa imagen y no es posible usar imágenes de referencia, clips de referencia ni audio para fijar el personaje y el estilo. En escenarios que requieran consistencia del personaje, se debe usar en su lugar un nivel que admita la generación de video a partir de imágenes de referencia.
¿Cómo se configuran el primer y el último fotograma para controlar el punto final del movimiento de cámara?

Use image_url para especificar el primer fotograma y el end_image_url opcional para especificar el último fotograma; el modelo interpola el movimiento entre ambos. El primer fotograma determina todo el lienzo de salida, así que la composición y la proporción del último fotograma deben ser similares a las del primero; de lo contrario, la interpolación tiende a producir deformaciones.
¿Puede la duración del video generado superar los 15 segundos?

La generación máxima por lote es de 15 segundos; no es posible producir un clip más largo de una sola vez. La salida real puede ser aproximadamente 0,7 segundos más larga que la duración (duration) especificada. Si necesitas un video final más largo, genera por segmentos de toma y luego únelos.

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-max-turbo/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para minimax-h3-max-turbo/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcional

Semilla aleatoria para controlar la aleatoriedad del resultado generado; si se omite, el sistema elige una semilla aleatoria automáticamente.

promptstringObligatoriominLength 1maxLength 50000

Indicación de texto para la generación del vídeo, que describe el contenido visual deseado.

durationnumberOpcionalPredeterminado: 5min 1max 15

Duración del vídeo (en segundos); se puede configurar entre 1 y 15 segundos, por defecto 5 segundos; la salida real puede ser unos 0,7 segundos más larga que el valor solicitado. Cuando se usa target_audio_url, la duración debe configurarse en al menos 2 segundos.

resolutionstringOpcionalPredeterminado: "768P"

Resolución de generación; puede ser 480P, 768P o 1080P, por defecto 768P; 1080P es un refinamiento en el espacio latente a partir de la fuente nativa de 768P, no una generación nativa.

Opciones:480P768P1080P

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del vídeo generado; puede ser 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16, por defecto 16:9.

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

target_audio_urlstringOpcional

Opcional; proporciona la URL de un audio de al menos 2 segundos y como máximo 15 MB para fijar la pista de audio del vídeo generado.

prompt_expansion_modestringOpcionalPredeterminado: "balanced"

Intensidad de la reescritura de la indicación antes de generar, por defecto balanced. disabled omite la expansión de la indicación; balanced devuelve en aproximadamente 1 segundo; quality tarda hasta unos 30 segundos en generar indicaciones más ricas.

Opciones:disabledbalancedquality

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-max-turbo/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "prompt_expansion_mode": "balanced"
  }
}'

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-max-turbo/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "768P",
      "aspect_ratio": "16:9",
      "prompt_expansion_mode": "balanced"
    }
  }),
});
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-max-turbo/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "768P",
          "aspect_ratio": "16:9",
          "prompt_expansion_mode": "balanced"
        }
    },
)
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"
    }
  }
}