MiniMax H3 API
Vídeo IAMiniMax H3 es la ruta de vídeo de MiniMax en OmniaKey: un solo identificador cubre texto a vídeo, un primer fotograma con un último opcional y planos guiados por referencias, en 768P o 2K.
- Por segundo de salida$0,0269–$0,0431
- OperacionesTexto a vídeo
- Imagen a vídeo
- Referencia a vídeo
- Ver precios de herramientas y reglas de facturación
Tu resultado aparecerá aquí cuando ejecutes el modelo.
01
Para qué sirve
MiniMax H3 es la ruta de vídeo de MiniMax en OmniaKey: un solo identificador cubre texto a vídeo, un primer fotograma con un último opcional y planos guiados por referencias, en 768P o 2K.
Elige MiniMax H3 cuando el plano necesite un fotograma inicial y final fijos o movimiento guiado por imágenes y vídeos de referencia, a $0.03 por segundo en 768P y $0.04 en 2K. Una referencia de audio sola se rechaza: acompáñala de una referencia de imagen o vídeo.
02
Qué hace
Texto a vídeo
minimax-h3
Genera un vídeo corto a partir de un texto.
Imagen a vídeo
minimax-h3
Anima una imagen fija en un vídeo corto.
Referencia a vídeo
minimax-h3
Guía el vídeo con material de referencia para mantener un personaje, un estilo o un movimiento.
03
En detalle
MiniMax H3 es el modelo de vídeo actual de la línea Hailuo, que aparece aquí como minimax-h3 con un solo ID del modelo para los tres tipos de tarea: texto, imagen (con un último fotograma opcional) y vídeo de referencia. MiniMax lo anunció el 31 de julio de 2026 como la generación posterior a Hailuo 01 y 02, y el nombre cambia según la página: la descripción del modelo en la API lo llama Hailuo-03.
Genera a 768P o 2K, admite duraciones en segundos enteros de 4 a 15 y acepta siete relaciones de aspecto, incluida una banda de 21:9. Todos los clips llegan con audio estéreo, y la referencia de creación de MiniMax no incluye ningún interruptor para silenciarlo, así que un máster en silencio hay que quitarlo después.
Nuestra prueba de octubre de 2026 envió un trabajo de 5 segundos a 768P por cada modo: los tres volvieron como MP4 H.264 a 24 fps, con 5,17 segundos de duración y AAC estéreo. A continuación se recogen las observaciones, incluido lo que el modelo inventó cuando el prompt no decía nada sobre el sonido.
Escenas que llevan su propia pista
H3 escribe ambiente a medida de la acción: agua corriendo justo antes de que aparezca la manguera, piano sobre un empujón de bicicleta. Escribe una frase de sonido junto a la visual y ambas llegan al mismo tiempo, lo que ahorra una pasada de foley en cortes cortos para redes sociales.
Primer y último fotograma en un solo trabajo
La operación de imagen toma un first_frame y un last_frame opcional, así que a un plano se le puede indicar dónde terminar y también dónde empezar. Así se planifica un corte de empalme hacia la siguiente escena sin una segunda generación.
Audio y vídeo de referencia juntos
La operación de referencia acepta reference_image, reference_video y reference_audio, y nuestro trabajo a 768P llevó una imagen, un vídeo y un archivo de audio a la vez. Ten en cuenta que un archivo de audio solo se rechaza: el sonido tiene que viajar con una imagen.
04
Notas de pruebas
Los tres clips de MiniMax H3 que hicimos en modo texto, imagen y referencia volvieron como archivos MP4 H.264 a 24 fps y 5,17 segundos con audio AAC estéreo.
Leer la pruebaPara imagen a vídeo omitimos por completo la relación de aspecto, y MiniMax H3 mantuvo la forma propia de la imagen fija y devolvió un clip de 1376x768.
Leer la pruebaCuando nuestros prompts de MiniMax H3 no decían nada sobre el sonido, el modelo añadió agua para el clip del robot y piano para el clip de la bicicleta.
Leer la pruebaNuestra prueba rápida del 16 de septiembre de 2026 completó un trabajo de referencia a vídeo de MiniMax H3 que llevaba juntos una imagen, un vídeo y una referencia de audio a 768P.
Cuando enviamos un trabajo de referencia de MiniMax H3 solo con un archivo de audio y sin imagen ni vídeo, la solicitud falló en lugar de iniciar una tarea.
05
Límites a tener en cuenta
- El sonido no se puede desactivar en la solicitud: no aparece ningún parámetro de audio en la referencia de creación, así que un clip en silencio hay que quitarlo del archivo terminado.
- Los medios de referencia no pueden mezclar tipos. Los fotogramas pertenecen a la operación de imagen y reference_image, reference_video y reference_audio a la operación de referencia, y un trabajo solo de audio se rechaza directamente.
- El cuerpo completo de la solicitud está limitado a 1 MiB, Base64 incluido, y por eso nuestro script envió JPEG de 1024 píxeles; las imágenes fijas a tamaño completo fallan antes de que exista la tarea.
- Solo 768P y 2K tienen precio. Una solicitud de 1080P o 4K se rechaza con un error de precio del modelo en lugar de reducirse, así que elige en el código un tamaño admitido.
06
Comparar modelos cercanos
| Modelo | Ideal para | Operaciones | Precio publicado |
|---|---|---|---|
| MiniMax H3Esta página minimax-h3 | 768P o 2K, de 4 a 15 segundos, sonido estéreo, primer y último fotograma, referencias de audio. | Texto a vídeo · Imagen a vídeo · Referencia a vídeo | $0,0269–$0,0431 por segundo |
| Wan 3.0 wan3.0-video | Borradores a 480P y tomas de 30 segundos a una tarifa menor, con audio que se puede desactivar. | Texto a vídeo · Imagen a vídeo · Referencia a vídeo | $0,04–$0,16 por segundo |
| HappyHorse 1.1 happyhorse-1.1 | Necesita un ID distinto por operación, llega hasta 1080P, pero añade un nivel de 480P. | Texto a vídeo · Imagen a vídeo · Referencia a vídeo | $0,042–$0,108 por segundo |
07
Fuentes y verificación
Guía actualizada el 2026-10-27.
08
Cómo llamarlo
Los modelos de medios funcionan de forma asíncrona: crea una tarea, consúltala hasta que termine y descarga la URL firmada del recurso.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: minimax-h3-001" \
-d '{
"model": "minimax-h3",
"type": "video",
"operation": "text_to_video",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"duration": 6, "resolution": "720p"}
}'
# 2. The same model id and the same poll loop serve the other operations:
# image_to_video media[] type "first_frame"
# reference_to_video media[] type "reference_image"
# Reference media travel alongside the prompt:
# {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
# A public HTTPS URL or a base64 data URI both work.
# 3. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 4. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"09
Precio
Los trabajos de vídeo se cobran por segundo de salida generado, no por token. Los trabajos fallidos o cancelados se reembolsan automáticamente.
$0,0269–$0,0431por segundoAhorra 82%
- 768P
- $0,0269por segundo
- 2K
- $0,0431por segundo
Artículos relacionados
Clapping Cat Meme AI: haz que tu mascota aplauda con imagen a vídeo
Una foto, un prompt y tres modelos: los tres hicieron que el gato se sentara y aplaudiera, pero la boca y la marca de agua cambiaron.
Leer artículoGuía de prompts de MiniMax H3: estructura, ejemplos y clips reales
Siete prompts y siete clips reales: qué cortes llegaron a tiempo, qué hicieron los campos de sonido y en qué carteles salió texto ilegible.
Leer artículoHailuo API: guía de MiniMax H3 en Python y 3 modos de video probados
Un script, tres modos: crear la tarea, consultarla y descargar el MP4. Todos los clips volvieron con sonido.
Leer artículoPreguntas frecuentes
¿Cómo llamo a MiniMax H3 en OmniaKey?
Envía un POST a /v1/media/tasks con el id del modelo, type "video" y operation "text_to_video"; o "image_to_video" con un primer fotograma en input.media[] (type "first_frame"). Reutiliza la misma Idempotency-Key en los reintentos para que un timeout nunca inicie un segundo trabajo de pago.
¿Cuánto cuesta MiniMax H3?
MiniMax H3 se cobra a $0,0269–$0,0431 por segundo de vídeo generado. La creación pre-cobra la duración solicitada de tu saldo prepago y los trabajos fallidos o cancelados se reembolsan automáticamente.
¿Por qué la API devuelve un id de tarea en lugar del vídeo?
El renderizado de vídeo tarda entre un minuto y varios minutos, así que OmniaKey ejecuta todas las rutas de vídeo con el mismo ciclo asíncrono. Consulta GET /v1/media/tasks/{id} hasta que el estado sea succeeded y luego lee la URL firmada del recurso.
¿Cuánto puede durar un clip de MiniMax H3?
De 4 a 15 segundos enteros, definidos con duration. Los valores fraccionarios no forman parte del rango, así que planifica los cortes en segundos enteros. Nuestros trabajos pidieron 5 y volvieron con 5,17 segundos, lo que es relleno normal del contenedor y no metraje adicional.
¿Puedo desactivar el sonido?
No mediante la solicitud. La referencia de creación de MiniMax no incluye ningún interruptor de audio para H3, y nuestros clips llevaban todos una pista AAC estéreo incluso cuando el prompt no mencionaba el sonido. Si un cliente necesita silencio, quita el audio en la edición o al descargar.
¿Qué ocurre si envío solo una referencia de audio?
La solicitud se rechaza antes de crear una tarea. El audio de referencia tiene que viajar con una imagen de referencia o un vídeo de referencia, que es la regla que indican los documentos y con la que se encontró nuestro propio trabajo solo de audio. Añade una imagen al mismo trabajo y continúa.
¿Mantiene la forma de mi imagen fija?
Sí, cuando omites aspect_ratio en un trabajo de imagen. Nuestro archivo de 1376x768 siguió a la imagen fija en lugar de rellenarse a 16:9, y MiniMax documenta que la operación de imagen sigue a la imagen mientras que el texto necesita una relación fija. Compón la imagen fija con la forma de entrega.
¿Con qué resoluciones debo presupuestar?
768P o 2K. Una solicitud de 1080P o 4K vuelve como error de precio del modelo, ya que H3 no tiene ese nivel, así que un script que herede un tamaño de otro modelo fallará aquí. Nuestros propios trabajos se ejecutaron todos a 768P; prueba 2K una vez antes de una sesión que dependa de ello.
