ProPainter

ProPainter reconstruye las regiones marcadas con una máscara en un video existente, incluidas aquellas de las que se quiere eliminar un objeto. Tiene sentido evaluarlo si puedes preparar el material y las máscaras, comprobar la licencia para el uso previsto y revisar la reparación en movimiento. No garantiza una edición imperceptible. La pregunta útil es si permite reparar tu plano sin estropear las partes que necesitas conservar. Proyecto oficial

Esta evaluación se basa en fuentes; no hemos realizado pruebas prácticas con una GPU. La versión en inglés de la que parte esta adaptación consultó la documentación y la implementación de los autores el 10 de septiembre de 2026. El ejemplo de estudio, el registro de ejecución y la ficha de aceptación que aparecen a continuación son métodos de evaluación propuestos para esta guía. No son experimentos realizados por nosotros ni resultados publicados por los investigadores.

Revisiones de las fuentes consultadas: código e870e793.

Define el plano que necesitas reparar

Imagina un video grabado en un estudio con una bolsa junto a una silla. Eliminar la bolsa solo resuelve una parte del trabajo. La pata de la silla debe conservar su forma, el dibujo del suelo tiene que mantenerse estable durante el movimiento de cámara y la zona reparada no debería llamar la atención al reproducir el video normalmente. Una miniatura limpia no basta si, un segundo después, el suelo empieza a moverse de forma independiente del resto de la escena.

Antes de instalar nada, escribe las condiciones de la edición en una frase: eliminar la bolsa, conservar la silla y el suelo y mantener el encuadre original. Después, identifica el intervalo difícil. Puede ser el instante en que la bolsa se superpone a la silla o aquel en que el movimiento de cámara deja ver más suelo. Incluye ese intervalo en la prueba, en lugar de escoger únicamente la parte más sencilla del video.

Separa las condiciones indispensables de las preferencias. Conservar intacta la pata de la silla puede ser obligatorio, mientras que una pequeña diferencia de textura en un fondo poco definido quizá resulte aceptable para tu proyecto. Decide esos criterios antes de comparar los resultados. De lo contrario, podrías terminar rebajando la exigencia para adaptarla a la salida que haya producido el modelo.

Conserva el original sin modificar y anota dónde se utilizará la edición. Una investigación experimental, una edición personal y un encargo remunerado plantean distintas cuestiones prácticas y de licencia. La viabilidad técnica no resuelve el permiso de uso. Tampoco la reputación del modelo demuestra que una reparación concreta esté lista para entregar.

Distingue el método de investigación del servicio de edición

ProPainter es un proyecto del S-Lab de Nanyang Technological University presentado en ICCV 2023. Sus autores describen tres componentes principales: completado recurrente del flujo óptico, propagación en los dominios de imagen y de características y un Transformer de video disperso guiado por máscaras. El modelo combina información entre fotogramas, en vez de tratar cada reparación como una imagen estática independiente. Descripción del método

El artículo original sitúa ese diseño en el contexto de investigaciones anteriores sobre relleno de video, entre ellas E2FGVI. Esa relación no convierte a ProPainter en una simple actualización de E2FGVI. Una comparación académica tampoco establece un ganador universal para todas las tareas actuales de edición. No hemos reproducido los experimentos del artículo. Artículo original

Al elegir un flujo de trabajo, conviene distinguir el método de investigación de un servicio que resuelve la edición completa. El código descargable, un nodo creado por la comunidad y una interfaz alojada pueden diferir en instalación, controles, tratamiento de datos y condiciones. Esta guía aborda la implementación de los autores. Una herramienta externa que usa el mismo nombre no necesariamente ofrece los mismos ajustes ni concede los mismos derechos.

Aclara la licencia antes de dedicar tiempo a una prueba

La S-Lab License 1.0 publicada permite usos no comerciales sujetos a sus condiciones y remite las consultas de uso comercial a los colaboradores del proyecto. El acceso público al código no equivale a un permiso comercial sin restricciones. Lee la licencia vigente del código y de los modelos. Si el uso previsto no está claramente cubierto, pide una aclaración al titular de los derechos. Condiciones de la licencia

Anota por separado tres decisiones: el permiso para editar el material original, el permiso para utilizar este modelo en el proyecto y las condiciones de cualquier servicio de alojamiento que intervenga. Resolver una no resuelve las demás. En particular, que una demostración online funcione no acredita derechos de uso comercial, confidencialidad ni una cuota ilimitada.

Para el ejemplo de estudio, coloca la decisión sobre los derechos al principio del registro de ejecución. Si la entrega será comercial y no dispones del permiso necesario, detén ahí la evaluación para ese uso. Puedes investigar otro flujo permitido sin afirmar que el resultado técnico de ProPainter habría sido inadecuado. Se trata de una limitación de uso, no de una valoración de la calidad del modelo.

Prepara una prueba pequeña que puedas explicar después

Empieza por el repositorio oficial. La instalación documentada utiliza Python 3.8 y pesos preentrenados. Es el punto de partida de los autores, no una certificación nuestra de compatibilidad con cualquier sistema operativo, versión de Python o entorno de GPU actual. El archivo de dependencias contiene paquetes sin una versión fijada e intervalos de versiones. Conservar las versiones realmente instaladas es necesario para reproducir las condiciones.

Utiliza un entorno aislado y guarda las notas de instalación junto con la prueba. Prueba primero una muestra oficial y después un plano representativo de tu material. Proponemos ese orden para separar un problema del entorno de una dificultad con las máscaras. Si la muestra no se ejecuta, cambiar la máscara de la bolsa no explicará el fallo de instalación.

Antes de procesar, crea un registro con un nombre único. Incluye el archivo de entrada, el intervalo elegido, las dimensiones de los fotogramas, la ubicación de las máscaras, la revisión del repositorio, los pesos, las versiones del entorno y los argumentos exactos. Al terminar, añade la ubicación de la salida, el estado de finalización y las observaciones. No sobrescribas la prueba anterior cuando cambies un ajuste.

El registro debería permitir responder una semana después qué cambió exactamente entre el resultado aceptable y el que falló. “Probé con más calidad” no responde a esa pregunta. Una anotación útil identifica el control modificado, el motivo del cambio y el defecto que pretendías corregir.

Comprueba las máscaras antes de ajustar el modelo

La implementación de inferencia recibe material de video y máscaras. Repite una única máscara suministrada a lo largo de la secuencia; cuando recibe una carpeta de máscaras, lee los archivos en el orden de sus nombres. Revisa la implementación de la versión elegida antes de dar por hecho que una interfaz externa se comporta igual. Carga de máscaras

En el ejemplo de la bolsa, superpón la máscara al primer fotograma, a uno intermedio y al último. Después, examina cada intervalo en el que cambie el contorno o la superposición. Comprueba que la zona seleccionada siga al objeto correcto sin invadir la pata de la silla. Decide por separado si también quieres eliminar la sombra. Una sombra evidente puede arruinar la intención de la edición aunque la bolsa desaparezca.

Verifica la correspondencia entre fotograma y máscara, las dimensiones y el orden de los nombres de archivo. Estas comprobaciones son especialmente relevantes al preparar secuencias de imágenes. Una máscara puede parecer correcta por sí sola y estar asociada al fotograma equivocado. Guarda una imagen con la máscara superpuesta para distinguir un error al seleccionar la entrada de un defecto de reconstrucción.

Durante el diagnóstico, cambia una sola variable cada vez. Ampliar la máscara, reducir la resolución y modificar los ajustes temporales a la vez puede producir una imagen diferente, pero no permite saber qué cambio ayudó. Conserva la primera prueba como referencia y asigna un propósito concreto a cada intento posterior.

Considera las consecuencias de los controles de memoria

Los argumentos de línea de comandos examinados incluyen los siguientes valores predeterminados. Describen la implementación, no una configuración recomendada para todos los videos.

Contrasta las definiciones de los argumentos con la revisión que guardaste. Los autores documentan opciones para reducir el consumo de memoria mediante cambios de precisión, resolución y contexto temporal. Sus cifras de ejemplo no constituyen un requisito mínimo de GPU válido para cualquier caso ni una promesa de velocidad. Inferencia con menor consumo de memoria

Si el obstáculo inmediato es la memoria, reduce el alcance de la prueba y registra la condición que has cambiado. Cuando termine la ejecución, vuelve a revisar el resultado. Que el proceso concluya no significa que la edición sea aceptable. Puede completarse y dejar una reparación que incumpla tus criterios sobre contornos protegidos o estabilidad en movimiento.

Registra por separado la instalación, las descargas iniciales, el procesamiento y los retoques manuales. Cada categoría responde a una cuestión de planificación distinta. La instalación puede reutilizarse en planos posteriores, mientras que las máscaras y el acabado pueden exigir trabajo en cada toma. No ofrecemos una estimación de velocidad por fotograma porque no hemos medido esta implementación con un equipo y una entrada especificados.

Evalúa la entrega con una ficha y marcas de tiempo

La ficha siguiente es una ayuda de evaluación original de esta guía. No es un benchmark validado ni una puntuación numérica de ProPainter. Antes de ejecutar la prueba, adapta las zonas que deben conservarse y las condiciones de entrega a tu edición.

Reproduce todo el resultado a velocidad normal antes de examinar fotogramas aislados. Después, compara el intervalo difícil con el original y registra cada defecto con su marca de tiempo y ubicación. “La pata de la silla se dobla cerca del suelo durante el movimiento de cámara” describe un problema que otra persona puede localizar. “La calidad es de siete sobre diez” no aporta esa información.

Pide a otra persona que vea la misma secuencia sin mostrarle primero tu fotograma favorito. Es un paso de revisión propuesto, no una afirmación de que un revisor independiente haya evaluado nuestro ejemplo. Facilita las condiciones de la edición y las zonas protegidas para que los comentarios respondan al trabajo real y no solo a preferencias personales.

Utiliza tres decisiones posibles: aceptar para este uso definido, corregir con una siguiente prueba concreta o detenerse y elegir otro método. Una corrección debe identificar la causa que se sospecha y la evidencia que confirmaría la mejora. Si no puedes plantear una siguiente comprobación razonable, otra ejecución con varios cambios arbitrarios probablemente aportará poca información.

Investiga los fallos sin perder las evidencias

Empieza por la entrada y la máscara antes de interpretar un problema de reconstrucción. La tabla propone un orden de investigación. No afirma que un síntoma demuestre una causa determinada.

No elimines las ejecuciones fallidas durante el diagnóstico. Un fallo puede demostrar que un cambio concreto no corrigió el defecto o que una configuración antes aceptable era sensible al entorno. Sin ese registro, corres el riesgo de repetir el mismo experimento con otro nombre de archivo.

El código de salida examinado escribe el video a partir de los fotogramas reconstruidos y no añade un paso que vuelva a incorporar el audio. Comprueba el sonido del archivo final por separado. Implementación de la escritura de salida Tras cualquier edición o exportación posterior, revisa también el archivo que realmente entregarás, no solo una vista previa intermedia.

Decide cuándo dejar de hacer pruebas

Antes de experimentar, fija un límite práctico de tiempo para instalación, preparación de máscaras, intentos de procesamiento y acabado. Es el presupuesto de tu proyecto, no un número universal de reintentos. Si el intervalo difícil sigue fallando y no hay un siguiente cambio diagnóstico claro, detente. Explorar más combinaciones de parámetros no garantiza un resultado utilizable.

Un parche con seguimiento de movimiento, una imagen del escenario sin el objeto, conocida como clean plate, o una nueva grabación son otros flujos que puedes investigar. La opción adecuada depende del video, del material disponible, de los permisos y del esfuerzo aceptable. No hemos comparado experimentalmente esos métodos con ProPainter. Se trata de un marco para decidir, no de una afirmación de superioridad.

Si lo que necesitas es generar una escena nueva a partir de una descripción de texto, estás resolviendo un problema distinto al de reparar material existente. Busca la categoría correspondiente en el directorio de modelos de IA, sin considerar que aparecer en una lista demuestra que un modelo sea adecuado. Para una tarea de relleno, conserva el original, las máscaras, los ajustes y la salida revisada en archivos separados. La reconstrucción es una edición, no una prueba de lo que había realmente detrás del objeto.

La evaluación terminada debería permitirte justificar una decisión sobre un plano bien definido: el uso está permitido, se ha examinado el intervalo crítico, las zonas protegidas siguen siendo aceptables y el archivo de entrega cumple la especificación. Si alguna condición continúa sin resolver, anótala y deja pendiente la aceptación. Un fotograma atractivo no sustituye una comprobación que todavía falta.