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
Director de cine junto a una cámara de cine en un plató con iluminación profesional

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.
Creador dirigiendo un rodaje de vídeo de producto con cámara e iluminación profesionales

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.
hailuo_h3_refs: generación guiada por referencias

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.
Acceso unificado e independiente por API
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 POST https://api.goenhance.ai/api/v1/videos/generations. La respuesta devuelve un img_uuid; la generación continúa de forma asíncrona.

Duración y prompt de hailuo_h3

duration 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. prompt 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, ratio acepta 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16. Cuando image_url aporta un primer fotograma, la salida sigue esa imagen y el parámetro ratio no se usa.

Entradas de fotograma en hailuo_h3

Pasa image_url como primer fotograma y, opcionalmente, image_end_url 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 ref_imgs, 3 vídeos en ref_videos y 3 clips de audio en ref_audios. 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 los niveles de precio y los créditos.

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.
Crear una API Key
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.

Preguntas frecuentes sobre la API de MiniMax H3

¿Qué duración acepta la API de MiniMax H3?

Tanto hailuo_h3 como hailuo_h3_refs aceptan cualquier entero de 5 a 15 segundos, con valor por defecto 5. Los valores no enteros o fuera de rango se rechazan antes de descontar tokens.

¿Por qué hay dos IDs de modelo para H3?

MiniMax trata el control de fotogramas y el material de referencia como mutuamente excluyentes. Por eso GoEnhance ofrece hailuo_h3 para flujos de primer y último fotograma y hailuo_h3_refs para generación guiada por referencias, en lugar de combinar parámetros que chocan en tiempo de ejecución.

¿Son 480p y 720p niveles de salida oficiales de MiniMax?

No. MiniMax solo produce 2K de forma oficial. Los niveles 480p y 720p de hailuo_h3 funcionan sobre el pipeline propio de GoEnhance. Te permiten iterar más barato y usar 2K solo en las tomas que te quedas.

¿Por qué cuesta más hailuo_h3_refs?

hailuo_h3_refs pasa únicamente por el canal oficial de MiniMax. Sus resoluciones disponibles son 768P y 2K, con tarifas por segundo de $0.099 y $0.143 respectivamente.

¿Cómo funciona la facturación?

El uso se factura con tokens: $10 compran 500 tokens, es decir $0.02 por token. El vídeo se factura por segundo a la tarifa indicada. Los puntos se descuentan una sola vez al enviar la tarea y se reembolsan por completo si la generación falla.

¿MiniMax H3 genera audio?

Sí. H3 genera diálogo, efectos de sonido y ambiente de sala en estéreo nativo en la misma pasada que el vídeo, en lugar de añadir un doblaje después.

¿Cómo sé cuándo está listo un vídeo?

Guarda el img_uuid devuelto y consulta el endpoint de detalle del trabajo, o registra una URL de callback. El callback de inicio usa status=0; el callback final trae el resultado.

¿GoEnhance Open API está afiliada a MiniMax o Hailuo?

No. GoEnhance Open API es una plataforma de API independiente de terceros. No es MiniMax ni Hailuo, y no está afiliada a MiniMax ni cuenta con su respaldo. Los nombres identifican el modelo y pertenecen a su titular.

¿Dónde está el editor sin código de MiniMax H3?

Esta página trata la integración por REST API. Si buscas un editor para usuarios finales, visita la página del modelo de vídeo MiniMax H3.

Empieza tu integración con la API de MiniMax H3