MiniMax

MiniMax H3

minimax-h3-max/text-to-video

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

Especificaciones	Precio unitario
480P	$0.072
768P	$0.115
1080P	$0.229

Descripción general

minimax-h3-max/text-to-video es la línea de generación de video guiada por texto de MiniMax para escenarios de texto a video: basta con introducir un mensaje en lenguaje natural para producir un clip de video corto con pista de audio sincronizada. Admite una duración máxima de 15 segundos, resoluciones de 480P a 1080P y seis relaciones de aspecto, además de ofrecer expansión de prompt y audio objetivo sustituible. Es adecuada para desarrolladores que necesitan producir por lotes muestras de storyboard, material publicitario o videos verticales cortos, y puede integrarse en flujos de producción mediante la interfaz unificada de HiAPI.ai.

Aspectos destacados

El prompt puede describir directamente la imagen, la acción y el sonido: el prompt transporta a la vez descripciones visuales y auditivas, y el video de salida incluye una pista de audio coincidente, lo que elimina el paso de doblaje y sincronización posterior.
Expansión del prompt con tres niveles de control: prompt_expansion_mode ofrece los niveles disabled, balanced y quality, lo que permite elegir según sea necesario entre mantener la intención original y mejorar el detalle.
Amplia cobertura de duración y relaciones de aspecto: la duración puede configurarse de 0.92 a 15 segundos, y las relaciones de aspecto abarcan seis opciones, de 21:9 a 9:16, de modo que el material horizontal, cuadrado y vertical puede generarse en una sola configuración.
Pista de audio sustituible: al pasar target_audio_url se puede sustituir la pista de audio de salida; si el audio es demasiado largo se recorta el inicio y si es demasiado corto se rellena con silencio, lo que facilita la alineación con una banda sonora predefinida.

Descripción de capacidades

Texto a video parametrizado: la salida se controla mediante la combinación de prompt, duration, resolution y aspect_ratio; los valores predeterminados son 768P, 16:9 y 5 segundos, y pueden ajustarse a 1080P y relaciones de aspecto verticales según el canal de publicación.

Salida de audio sincronizada: al generar el video se produce también el audio coincidente, lo que resulta adecuado para material de video corto que debe estar listo para usar, ya que reduce el trabajo de posproducción de audio.

Expansión del prompt: cuando el prompt es demasiado escueto, se activan los modos balanced o quality para que el modelo complete los detalles; si se necesita reproducir estrictamente la descripción original, se cambia a disabled.

Sustitución de pista de audio y restricción de duración: al proporcionar target_audio_url se puede incorporar audio propio, y cuando se pasa un audio la duración mínima se ajusta a 2 segundos para evitar desajustes entre una pista demasiado corta y la imagen.

Semilla aleatoria reproducible: el campo seed admite fijar una semilla aleatoria para reproducir el mismo resultado; pasar explícitamente 0 se transmite con normalidad, lo que facilita la depuración y la comparación por lotes.

Casos de uso

Equipos de video corto: generar muestras a partir de una descripción de storyboard de una frase: se introducen el texto del plano y los parámetros de duración y relación de aspecto para obtener rápidamente un clip con sonido, útil para pruebas de storyboard y confirmación con el cliente.
Publicidad: producción por lotes en varias relaciones de aspecto: con el mismo prompt se alternan proporciones como 16:9, 9:16 y 1:1 para producir material vertical y cuadrado listo para publicar en cada canal.
Creadores de contenido: generación de piezas guiadas por banda sonora: se pasa audio propio como target_audio_url y se genera una imagen que coincide con la duración de la pista, útil para videos cortos a ritmo y contenido musical.
Desarrolladores de aplicaciones: integración de la interfaz de video programática: mediante la interfaz unificada de HiAPI.ai se realizan llamadas por lotes según seed y parámetros, e se integra el texto a video en flujos de producción de contenido o automatización de marketing.

Limitaciones y recomendaciones de selección

La duración máxima por generación es de 15 segundos; las narrativas más largas requieren generar por segmentos y unirlos después. La resolución máxima es 1080P; si se necesita una salida de mayor calidad, conviene evaluar otras líneas. Al activar la expansión del prompt, el modelo añade detalles; si se exige una reproducción estricta de la descripción, se recomienda desactivarla. Al pasar audio personalizado, la duración mínima del video es de 2 segundos y la pista se recorta o se rellena con silencio, por lo que es necesario controlar la longitud del material. En escenarios con solo entrada de texto que requieran imágenes de referencia o control de primer y último fotograma, debe elegirse la línea de imagen a video de la misma serie.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria, utilizada para controlar la aleatoriedad de los resultados generados. Si se omite, el sistema la selecciona al azar; si se necesita fijar la semilla, pasar explícitamente 0 también debe especificarse.

promptstringObligatoriominLength 1maxLength 50000pattern \S

Indicación de texto que describe la imagen, la acción, el movimiento de cámara y el contenido de audio que se desea generar.

durationnumberOpcionalPredeterminado: 5min 0.92max 15

Duración del video generado, tipo numérico, por defecto 5.

resolutionstringOpcionalPredeterminado: "768P"

Resolución del video generado, tipo cadena, por defecto 768P.

Opciones:480P768P1080P

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video generado, tipo cadena, por defecto 16:9.

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

target_audio_urlstringOpcionalminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$

Dirección del audio de destino, utilizada para reemplazar la pista de audio del video de salida; el audio debe durar al menos 2 segundos y no superar los 15 MB, los audios más largos se recortan al principio y los más cortos se rellenan con silencio.

prompt_expansion_modestringOpcionalPredeterminado: "balanced"

Modo de expansión de la indicación, controla la estrategia de expansión automática de la indicación de entrada, por defecto balanced.

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/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/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/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"
    }
  }
}