API de MiniMax H3 para generación de vídeo
Usa MiniMax H3 a través de la GoEnhance Open API, una plataforma independiente. Envía texto, imágenes de fotograma o material de referencia a un flujo REST asíncrono, recibe un img_uuid y luego consulta el resultado o registra un callback. H3 genera audio estéreo nativo —diálogo, efectos de sonido y ambiente de sala— en la misma pasada que la imagen.
Crear una API Key
Elige el modelo H3 que encaja con tus entradas
hailuo_h3: texto, primer fotograma o primer y último fotograma
Usa hailuo_h3 para texto a vídeo, para imagen a vídeo con image_url, o para control de primer y último fotograma añadiendo el opcional image_end_url. El prompt es obligatorio y admite hasta 7.000 caracteres. Consulta el playground y la referencia completa de parámetros.
hailuo_h3_refs: generación guiada por referencias
Usa hailuo_h3_refs cuando una sola petición necesite hasta 9 imágenes, 3 vídeos y 3 clips de audio de referencia. Esta ruta pasa por el canal oficial de MiniMax y ofrece salida en 768P y 2K. Consulta el endpoint de referencia a vídeo.
Acceso unificado e independiente por API
GoEnhance Open API es una plataforma independiente de terceros que ofrece acceso unificado a modelos de vídeo e imagen. No es MiniMax ni Hailuo, no está afiliada a MiniMax ni cuenta con su respaldo. MiniMax y Hailuo son marcas de su titular y aquí se usan únicamente para identificar el modelo.
Valida estos campos antes de enviar para que las peticiones inválidas se rechacen antes de descontar tokens.
Parámetros y límites de la API de MiniMax H3
Endpoint compartido y respuesta asíncrona
Ambos modelos se envían a <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>. La respuesta devuelve un <code>img_uuid</code>; la generación continúa de forma asíncrona.
Duración y prompt de hailuo_h3
<code>duration</code> debe ser un entero de 5 a 15 segundos y su valor por defecto es 5. Los valores no enteros o fuera de rango se rechazan antes de descontar tokens. <code>prompt</code> es obligatorio y admite hasta 7.000 caracteres.
Resolución y relación de aspecto de hailuo_h3
Elige 480p, 720p o 2K. Solo en texto a vídeo, <code>ratio</code> acepta 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16. Cuando <code>image_url</code> aporta un primer fotograma, la salida sigue esa imagen y el parámetro ratio no se usa.
Entradas de fotograma en hailuo_h3
Pasa <code>image_url</code> como primer fotograma y, opcionalmente, <code>image_end_url</code> como último. Este único ID de modelo cubre texto a vídeo, imagen a vídeo y generación con primer y último fotograma.
Entradas de referencia en hailuo_h3_refs
Una sola petición admite hasta 9 imágenes en <code>ref_imgs</code>, 3 vídeos en <code>ref_videos</code> y 3 clips de audio en <code>ref_audios</code>. La duración es un entero de 5 a 15 segundos con valor por defecto 5; la resolución es 768P o 2K.
Audio estéreo nativo
H3 genera diálogo, efectos de sonido y ambiente de sala como audio estéreo nativo en la misma pasada que la imagen, en lugar de doblar el audio después.
El coste por llamada es la tarifa por segundo del nivel elegido multiplicada por la duración de salida solicitada. Los modelos de vídeo se facturan por segundo de salida.
Precio por segundo de MiniMax H3
hailuo_h3 — 480p: $0.030 por segundo
Un nivel del pipeline propio de GoEnhance para iterar prompts a menor coste. No es un nivel de salida con soporte oficial de MiniMax.
hailuo_h3 — 720p: $0.060 por segundo
Un nivel del pipeline propio de GoEnhance para iterar más barato antes de elegir las tomas finales. No es un nivel de salida con soporte oficial de MiniMax.
hailuo_h3 — 2K: $0.090 por segundo
Usa el nivel 2K para las tomas elegidas que necesiten la resolución de salida oficial de MiniMax.
hailuo_h3_refs — 768P: $0.099 por segundo
La generación guiada por referencias pasa por el canal oficial de MiniMax y por eso usa niveles y precios distintos.
hailuo_h3_refs — 2K: $0.143 por segundo
El nivel 2K del canal oficial para peticiones guiadas por referencias.
Tokens, reembolsos y concurrencia
El uso se factura en tokens: $10 compran 500 tokens, es decir $0.02 por token. Los puntos se descuentan una sola vez al enviar y se reembolsan por completo si la generación falla. La concurrencia depende del Build Tier de la cuenta y empieza en 3 tareas sin terminar a la vez. Consulta <a href="/billing">los niveles de precio y los créditos</a>.
Integra la API de vídeo de MiniMax H3
1
1. Crea y protege una API key
Crea una key en /keys. Envíala como
Authorization: Bearer <API key> y no la expongas en código de navegador ni en logs. 2
2. Elige modelo y valida la petición
Elige
hailuo_h3 para texto o control de fotogramas, o hailuo_h3_refs para material de referencia. Antes de enviar, valida la duración, la resolución, si ratio aplica, la longitud del prompt y el número de entradas. 3
3. Envía y guarda el img_uuid
Haz POST de la petición a
https://api.goenhance.ai/api/v1/videos/generations. Guarda el img_uuid devuelto junto a tu propio registro del trabajo, porque la tarea es asíncrona. 4
4. Consulta o recibe callbacks
Consulta
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... o registra una URL de callback. Cuando la tarea empieza a ejecutarse se dispara un callback con status=0; el callback final trae el resultado. 5
5. Gestiona validación, fallos y concurrencia
No reintentes sin cambios una duración inválida o una combinación de entradas incompatible. Las generaciones fallidas se reembolsan por completo. Pon las peticiones en cola cuando las tareas sin terminar alcancen la concurrencia que permite tu Build Tier.
Monta pipelines de medios repetibles en torno a trabajos asíncronos, audio nativo y entradas explícitas de fotograma o referencia.
Qué construyen los desarrolladores con H3
Variantes publicitarias programáticas
Genera lotes de conceptos breves de campaña a partir de prompts estructurados y quédate solo con los resultados aprobados.
Pipelines de clips de producto
Usa una imagen de producto como primer fotograma y genera clips cortos cuya proporción sigue la imagen aportada.
Anuncios de vídeo localizados
Genera imagen, diálogo, efectos de sonido y ambiente de sala en una sola pasada y luego pasa cada resultado por tu flujo de localización y revisión.
Sistemas de producción de UGC
Conecta envíos, seguimiento de trabajos, callbacks, moderación y almacenamiento de recursos en un pipeline automatizado de contenido breve.
Límites, elección de modelo, facturación, audio y relación con la plataforma.