Cómo automatizar plugins de Wan2GP desde la línea de comandos

Al trabajar con herramientas como Wan2GP, a menudo surge la necesidad de automatizar flujos de trabajo complejos. ¿Es posible ejecutar plugins directamente desde la línea de comandos? Aunque no existe un parámetro nativo tipo --plugin, descubrimos que podemos lograr una automatización completa manipulando los archivos de cola del sistema.

Automatizando Plugins vía CLI

El plugin Process Full Video está diseñado para la interfaz gráfica, pero no significa que sea imposible usarlo en modo headless. La clave reside en el uso de archivos como queue.zip o configuraciones .json. El flujo consiste en configurar la tarea en la GUI, guardar la cola generada y luego ejecutarla desde consola.

Terminal ejecutando un script para procesar videos automáticamente.
Ejecución del plugin mediante el procesamiento de archivos de cola.

En lugar de buscar un comando mágico, el enfoque práctico es procesar archivos guardados. Wan2GP permite ejecutar tareas en modo headless simplemente pasándole la cola a través del parámetro --process. Esto demuestra que los plugins pueden interactuar con la API interna y las colas de generación sin necesidad de abrir la aplicación completa.

El Formato de la Cola y los Límites

Al inspeccionar el archivo queue.json, encontramos una estructura sorprendentemente simple: es simplemente una lista de objetos con un campo id y un bloque params. No hay hashes, checksums ni dependencias complejas entre tareas. Esto facilita enormemente la automatización: para procesar múltiples videos, solo necesitamos duplicar el bloque del trabajo dentro del JSON e incrementar el ID.

Diagrama mostrando la segmentación de videos y el formato de cola.
División del video y estructura JSON para procesamiento por lotes.

Además, al analizar los límites de duración, descubrimos que no existe un límite duro absoluto. El campo video_length en las colas suele referirse a frames (alrededor de 5-7 segundos), pero la implementación de Sliding Window permite generar videos más largos mediante ventanas consecutivas.

No obstante, para casos prácticos como el outpainting o el procesamiento completo, es mucho más robusto dividir el video en segmentos y procesarlos secuencialmente. Si una tarea falla, no pierdes horas de cómputo. Automatizar la generación de estos lotes mediante un script simple es la vía más eficiente y segura.