comfyui-h3-facerefine

ComfyUI-H3-FaceRefine es un conjunto de nodos personalizados de ComfyUI para el posprocesamiento de vídeo de MiniMax H3. Aborda el caso en que H3 representa las caras con poca calidad porque una cabeza ocupa solo una parte pequeña del fotograma original. La canalización detecta y rastrea una cara, normaliza el recorte a un lienzo mayor, pasa ese recorte por H3 y cose la cara generada de vuelta en el vídeo original usando la transformación de recorte registrada. Su enfoque está modelado sobre FaceDetailer de Impact Pack, pero ampliado para el trabajo de vídeo fotograma a fotograma. Los componentes principales incluyen: - H3 Load Video + Face Select: carga vídeo y audio, detecta caras, detecta opcionalmente cortes secos y selecciona un sujeto antes de que se ejecute el grafo. Puede usar una interfaz manual Pick faces, reglas de clasificación o una imagen de referencia de identidad. - H3 Face Track + Crop: rastrea el sujeto seleccionado en cada plano, genera recortes y datos de transformación, entrega las dimensiones del lienzo y el número de fotogramas, y gestiona el suavizado, la interpolación, las caras faltantes y los límites de plano. - H3 Per-Frame Denoise: aplica controles de eliminación de ruido por fotograma como un parche de la ruta del modelo, tomando y devolviendo una entrada MODEL. - H3 Face Stitch Back: compone la salida refinada de H3 de vuelta en los fotogramas originales y conserva la ruta de audio original. La selección de sujeto admite modos de clasificación automática, como mayor tamaño, menor tamaño, más a la izquierda, más a la derecha, más arriba, más abajo, más centrada, más cercana a las coordenadas X/Y y puntuación del detector. La selección basada en identidad puede usar InsightFace para caras fotográficas, mientras que se sugiere CLIP Vision o CCIP para material ilustrado o anime. Se requiere un detector de caras proporcionado por el usuario, como face_yolov8m.pt; se recomienda un detector de caras anime para contenido no fotográfico. El paquete usa PySceneDetect para la detección opcional de cortes secos. Cuando está disponible, los cortes dividen el vídeo en planos, de modo que el sujeto puede seleccionarse por separado en cada plano y el rastreo no se suaviza a través de un corte. Si PySceneDetect no está disponible, el vídeo se trata como un único plano. Los informes de rastreo identifican los rangos de fotogramas perdidos, y los fotogramas perdidos pueden resaltarse en la vista previa. Cuando el sujeto desaparece, el rastreador evita saltar a otra persona y puede interpolar el recorte mientras desvanece la composición para conservar los píxeles originales. Se incluyen dos plantillas de flujo de trabajo anotadas: Auto Select, donde una regla de clasificación elige la cara, y Manual Select, donde el usuario elige una cara por plano. Las plantillas están disponibles mediante el navegador de plantillas de ComfyUI y también pueden cargarse desde el directorio example_workflows. Usan el número de fotogramas y las dimensiones del lienzo del nodo de rastreo para mantener la generación de H3 alineada con el clip original. La instalación se realiza clonando el repositorio en ComfyUI/custom_nodes y reiniciando ComfyUI. Los nodos aparecen bajo el menú MiniMax H3/Face Refine. Los paquetes de Python, incluidos ultralytics, scipy, insightface y scenedetect, pueden instalarse desde los requisitos del proyecto. Se requiere una compilación reciente de ComfyUI con los nodos principales de MiniMax H3, junto con el modelo H3, el codificador de texto y el VAE, salvo que ya estén instalados. Los flujos de trabajo de ejemplo usan además VideoHelperSuite para guardar, ComfyUI-H3-NativeAudioLock para la gestión de audio y sincronización labial, e Impact Pack para el registro de carpetas de modelos. Los componentes SAM y GGUF están presentes pero silenciados por defecto; los modelos SAM, la compatibilidad con cargadores GGUF, CLIP Vision, los modelos InsightFace y los turbo LoRAs son opcionales según la configuración del flujo de trabajo. Para los vídeos cargados pegando una ruta absoluta, el paquete sirve vistas previas locales fuera del directorio input de ComfyUI. Si se establece H3_FACEREFINE_STRICT_PATHS en un valor no vacío, se restringen esas rutas a archivos dentro de la propia carpeta de ComfyUI, lo cual es útil cuando ComfyUI está expuesto más allá de localhost.