Cómo usar MiniMax H3: pesos abiertos y API

MiniMax H3 puede utilizarse mediante los pesos abiertos de H3-Base o la API alojada de MiniMax. Elige los pesos abiertos si necesitas inferencia autohospedada y control a nivel de modelo. Elige la API si quieres generar contenido dentro de una aplicación o un flujo automatizado sin operar servidores de modelos.

La mejor vía depende de qué tareas quieras asumir. Esta guía explica cómo empezar con cada opción y compararlas mediante una prueba repetible.

Pesos abiertos o API: ¿qué vía de H3 deberías elegir?

Usa los pesos abiertos si los archivos del modelo deben ejecutarse en una infraestructura que controlas. Esta vía también es adecuada para investigación, código de inferencia personalizado o experimentos con canalizaciones locales.

Usa la API de MiniMax si quieres lanzar una función, automatizar lotes o probar H3 sin mantener infraestructura de GPU. Aun así, tendrás que crear el flujo de trabajo que rodea cada tarea de generación.

Si ambas vías encajan, empieza con la API. Suele ofrecer al equipo de desarrollo el camino más corto hasta una solicitud de H3 funcional. Pasa a los pesos abiertos solo cuando el autohospedaje resuelva un requisito concreto.

Cómo ejecutar H3-Base con pesos abiertos

MiniMax lanzó dos familias de checkpoints H3-Base. FL2VA maneja la generación de texto y la guía del primer fotograma, del último fotograma o del primer y último fotograma. Ref2VA utiliza imágenes de referencia, videos y audio opcional para guiar el resultado.

El lanzamiento público es solo la etapa Base del sistema H3 más grande. H3-Base genera una salida audiovisual de 768p. Los componentes alojados Context-IR y Regenerate-2K de MiniMax no están incluidos en el paquete de pesos abiertos actual.

Elige el checkpoint antes de descargar archivos

Elige el checkpoint según el tipo de entrada que realmente vayas a utilizar:

No descargues Ref2VA sólo porque suena más avanzado. FL2VA es la opción directa para trabajos de texto y fotogramas de punto final. Ref2VA ofrece un flujo de trabajo de entrada diferente.

Crea un flujo de trabajo local antes de agregar componentes personalizados

1. Lee la licencia y la tarjeta del modelo. Confirma que tu uso, ubicación, plan de distribución y organización se ajusten a los términos publicados.
2. Elige una ruta de inferencia admitida. MiniMax enumera SGLang, vLLM, Diffusers y ComfyUI en el repositorio oficial H3.
3. Descarga el checkpoint correspondiente y los componentes necesarios. Mantén los archivos FL2VA y Ref2VA claramente separados.
4. Sigue la configuración oficial del entorno elegido. Fija las versiones de software que produzcan tu primer resultado correcto.
5. Ejecuta un trabajo simple. Guarda el prompt, las entradas, el flujo de trabajo, la semilla cuando esté disponible y la salida.
6. Registra el uso de recursos. Anota el tiempo de inicio, el pico de VRAM, el tiempo de generación, el almacenamiento y los fallos en tu propio hardware.

Evita comenzar con nodos comunitarios, adaptadores, cambios de cuantificación y un paquete de referencia complejo al mismo tiempo. Cuando falla la primera ejecución, demasiadas variables hacen que sea difícil encontrar la causa.

Qué te da y qué no te da el control local

El autohospedaje te permite controlar el entorno de servicio, el código auxiliar, la gestión de archivos y los ajustes de inferencia compatibles. También te permite crear tus propias canalizaciones de preprocesamiento y revisión.

Ese control no convierte a H3-Base en un sistema alojado completo. Un preprocesador personalizado no es la implementación Context-IR de MiniMax. Un escalador separado no es la etapa oficial de Regenerate-2K.

La implementación local también te traslada costos y responsabilidades. La computación, el almacenamiento, el tiempo de ingeniería, el monitoreo, las salvaguardas y las ejecuciones fallidas siguen siendo importantes. La privacidad depende de tus registros, reglas de acceso, almacenamiento de activos y componentes de terceros.

Cómo utilizar MiniMax H3 a través de la API

La ruta API elimina el alojamiento de modelos, pero no elimina el trabajo de la aplicación. La generación H3 se ejecuta como una tarea asincrónica: crea la tarea, conserva su ID, verifica su estado y recupera el resultado final.

Empieza con el ciclo de vida mínimo de API

1. Crea una cuenta de plataforma MiniMax y una clave API. Almacena la clave fuera del código del lado del cliente y de los repositorios públicos.
2. Elige un patrón de entrada. Empieza con texto o una solicitud basada en imágenes antes de agregar varias referencias.
3. Crea una tarea de generación de vídeo. Usa el modelo MiniMax-H3 e incluye un prompt que no esté vacío.
4. Guarda el ID de tarea devuelto. Asócialo con tu usuario, los archivos de entrada y los ajustes de la solicitud.
5. Consulta periódicamente el endpoint de estado de la tarea. Gestiona por separado los estados en curso, correcto y fallido.
6. Recupera y guarda el resultado. Descarga el archivo en un almacenamiento que controles en lugar de tratar la ubicación devuelta como permanente.

La guía oficial de generación de vídeo de MiniMax contiene los campos de solicitud y los detalles de los endpoints vigentes. Usa el schema actual en lugar de copiar un payload antiguo de un tutorial de terceros.

Añade medidas de protección cuando funcione la primera solicitud

Una vez que una solicitud se completa de principio a fin, agrega los controles circundantes:

• Valida los prompts y los medios antes de enviar una tarea paga.
• Evita envíos duplicados cuando un usuario actualiza o vuelve a intentar.
• Establece un intervalo de sondeo y una política de espera máxima.
• Separa los errores de solicitud de los errores de generación.
• Almacena los ID de las tareas para que las sesiones interrumpidas puedan recuperar sus trabajos.
• Realiza un seguimiento de los intentos fallidos y del coste final por resultado utilizable.
• Aplica tus propias reglas de acceso, moderación, retención y eliminación.

No escales la simultaneidad antes de poder recuperar limpiamente un trabajo fallido. Una llamada API exitosa es solo el comienzo de un flujo de trabajo de usuario confiable.

Compara ambas rutas con una pequeña prueba H3

Una comparación de rutas justa necesita los mismos criterios de origen, prompt, destino y aceptación. Mantén la primera prueba breve y visualmente simple.

Tarjeta de prueba reutilizable

Imagen fuente: Una imagen con licencia 16:9 de una taza de cerámica blanca mate sobre una mesa de madera. El asa y la etiqueta impresa deben ser claramente visibles.

Prompt:

Conserva la taza, el asa, la etiqueta, la mesa y el fondo de la imagen de entrada. El vapor sube lentamente de la taza mientras la cámara realiza un suave movimiento de aproximación. La etiqueta sigue siendo legible. El audio contiene un ambiente interior suave y un ligero tintineo de cerámica. Sin música.

Criterios de aceptación:

• La forma de la taza y el asa se mantienen estables.
• La etiqueta impresa sigue siendo legible.
• El vapor se mueve sin cambiar el diseño de la taza.
• La toma utiliza un movimiento lento en lugar de varios movimientos de cámara.
• El clip incluye ambiente interior y un tintineo de cerámica.
• No aparece música.

Usa la duración compartida y la relación de aspecto más cercanas disponibles en ambas rutas. Si una ruta no puede coincidir con una configuración, registra la diferencia en lugar de cambiar el objetivo creativo.

Registra el resultado, no solo el tiempo de renderizado

Para una ejecución local, registra también el hardware, el ejecutor, las versiones de software, la precisión o cuantificación, la VRAM máxima y la fuente del checkpoint. Para una ejecución de API, registra los estados de las tareas, los errores de respuesta y el comportamiento del almacenamiento.

Un resultado no puede demostrar que una ruta sea siempre más rápida o mejor. Puede revelar qué ruta se adapta a tu equipo, infraestructura y tolerancia actuales a intentos fallidos.

Solucionar los problemas de configuración más comunes

El flujo de trabajo local no se cargará

Comprueba que el checkpoint coincida con el flujo de trabajo. Después compara los nombres de archivo, las ubicaciones y las versiones de las dependencias con el repositorio oficial. Elimina los nodos y las optimizaciones de terceros hasta que se ejecute el flujo básico.

La API acepta la solicitud, pero tu aplicación pierde el resultado.

Conserva el ID de la tarea tan pronto como MiniMax lo devuelva. Tu interfaz debería reanudar las comprobaciones de estado después de una actualización o una falla temporal de la conexión. Copia los medios completados en tu propio almacenamiento.

La salida ignora parte del prompt.

Reduce la prueba a un sujeto, una acción, un movimiento de cámara y un objetivo de audio. Agrega complejidad solo después de que funcione la versión más pequeña. Para la generación basada en referencias, asigna a cada fuente un trabajo claro en lugar de pedirle a cada fuente que controle todo.

Los resultados locales y API no coinciden

Primero compara las entradas reales, el checkpoint o la etiqueta del modelo, la duración, la resolución, el prompt y cualquier configuración de inferencia. La versión abierta H3-Base y el servicio alojado no son rutas de sistema idénticas, por lo que no se debe asumir una paridad de salida exacta.

¿Qué vía de H3 se adapta a tu trabajo?

Mantén tus recursos de origen, prompts y criterios de aceptación portátiles. Facilitan la comparación de rutas sin tener que reconstruir el resumen creativo cada vez.

Preguntas frecuentes

¿Puedo usar MiniMax H3 sin tener una GPU?

Sí. Usa la API alojada de MiniMax si no quieres operar infraestructura de GPU. Aun así, necesitas una aplicación o un script que cree las tareas, compruebe su estado y guarde los resultados.

¿Los pesos abiertos de H3 son lo mismo que el servicio H3 alojado?

No. Los pesos públicos cubren H3-Base FL2VA y Ref2VA. El sistema completo también usa los componentes alojados Context-IR y Regenerate-2K, que no están en el paquete actual de pesos abiertos.

¿H3-Base local puede generar el resultado oficial completo a 2K?

No. La ruta local documentada de H3-Base genera 768p. La ruta oficial a 2K de MiniMax usa Regenerate-2K, que no está incluido en la publicación pública actual.

¿Debo elegir FL2VA o Ref2VA?

Elige FL2VA para generar a partir de texto o fijar los fotogramas inicial y final. Elige Ref2VA cuando las imágenes, el video o el audio opcional deban guiar la identidad, el estilo, el movimiento, la cámara, la voz o el sonido.

¿Puedo usar H3 en proyectos comerciales?

Posiblemente, pero las condiciones dependen de tu vía de acceso y tus circunstancias. Revisa la licencia comunitaria para los pesos abiertos y las condiciones actuales de la plataforma para el uso alojado. Comprueba las restricciones territoriales, de ingresos, atribución, distribución y uso antes de publicar.

Elige tu vía de acceso a MiniMax H3

Empieza con la API cuando te importe obtener rápidamente un resultado funcional. Elige los pesos abiertos cuando el autohospedaje o el acceso a nivel de modelo resuelvan un requisito concreto.

MiniMax H3 llegará pronto a DomoAI. Compartiremos la noticia cuando esté disponible.