MiniMax H3 Prompt Builder 1.8.0: ComfyUI 마스크 클립 편집

팩에 포함된 참조 모드 체인: Media Loader → Prompt Builder → MiniMax H3 Reference to Video.

마스크 클립 편집

버전 1.8.0은 H3 사용자들이 계속 마주치는 문제, 즉 클립에서 한 가지만 바꾸고 나머지 영상은 그대로 두는 방법에 답합니다. 마스크는 모델이 어디를 변경할 수 있는지 결정하고, 프롬프트는 그 영역이 무엇이 될지 결정합니다.

Media Loader에서 클립을 마우스 오른쪽 버튼으로 클릭하고 Mask for editing을 선택하면 마스크 탭이 열리며, 이 탭은 현재 트림, 크롭, 미러된 상태 그대로의 클립에서 동작합니다. 마스크는 이미지 편집기처럼 레이어를 쌓아 구성하며, 각 새 레이어는 자신의 영역을 Add하거나 아래 레이어에서 Cut할 수 있습니다:

• Auto Mask with SAM은 프롬프트와 점(dot)으로 마스크를 만듭니다. 선명한 프레임에서 대상을 클릭하고, 제외할 것은 마우스 오른쪽 버튼으로 클릭한 뒤, 그것이 무엇인지("초록색 재킷") 입력하면 점 아래의 해당 부분만 마스크됩니다. 여러 프레임에서 실행하면 표시한 각 프레임마다 추적이 다시 시드되며, 이렇게 드리프트하는 마스크를 복구합니다.
• Ellipse, Rectangle, Polygon 레이어는 손으로 그리고 키를 지정합니다. 다른 프레임에서 레이어를 이동하거나 크기 조정하면 피사체를 따라가며, 부드럽게(Smooth), 직선(Linear), Ease 보간과 프레임을 벗어나는 객체를 위한 숨김(Hidden) 키를 지원합니다.
• 브러시는 한 프레임에, 현재 위치부터 끝까지, 또는 클립 전체에 칠하거나 지웁니다.

Use this mask는 유지된 범위의 레이어를 병합하고 클립과 함께 저장해 계속 편집할 수 있게 하며, 그러면 카드에 Video 1 · editing이 표시됩니다. 그래프 쪽에서는 RefMod Text Encode가 편집을 구성하고, 새로운 Fantastic H3 Edit Composite 노드가 재생성된 영역만 정확히 원본 프레임에 다시 붙여 넣으므로 마스크 밖의 모든 것은 촬영된 그대로 유지됩니다.

마스크 경로에는 SAM 3.1 체크포인트인 sam3.1_multiplex_fp16.safetensors가 models/checkpoints에 있어야 합니다. 이 팩이 대신 다운로드해 주는 일은 없습니다.

RefMod 라이브러리: 재사용 가능한 참조 묶음을 생성, 편집, 정리하고 태그를 붙입니다.

더 빨라진 RefMod 인코딩

이제 RefMod는 텍스트 인코더에 보여지는 이미지들을 자체 파일 안에 보관하므로, 인코더가 실행할 때마다 이미지를 디코딩하지 않습니다. 이전 RefMod는 한 번 디코딩되어 캐시되며, 라이브러리의 Store encoder frames 동작은 해당 프레임을 예전 파일에 영구적으로 기록합니다.

Text Encode의 새로운 실험적 stack_pictures 설정은 RefMod의 이미지 중 몇 개가 인코더에 전달될지 선택합니다: 네 개마다 하나(이전 동작), 최대 여덟 개, 또는 전부입니다. 더 많이 보여주면 정체성 유지와 여러 RefMod 간 번짐 문제에 도움이 될 수 있지만, 메모리와 생성 시간 측면의 비용이 따릅니다.

1.8.0의 나머지 변경 사항

트림 및 크롭 편집기. 클립에서 프레임을 곧바로 뽑아 그림 참조 풀에 넣을 때도 사용합니다.

• 트림 편집기에 타임라인 확대/축소, 플레이헤드가 첫 번째 유지된 프레임에서 얼마나 지나 있는지 보여주는 표시, 닫기 전 저장되지 않은 변경 사항 경고, 그리고 뒤에 있는 그래프에 더 이상 영향을 주지 않는 Ctrl+Z가 추가되었습니다.
• 이제 모든 빌더 필드에서 선택된 텍스트를 마우스 오른쪽 버튼으로 클릭하면 "save selection as phrase"와 함께 Copy, Cut, Paste, Remove가 표시됩니다.
• Media Loader의 Clean up은 아무것도 사용하지 않는 마스크 파일과 오래된 저장 latent를 삭제하고, 저장된 미디어 세트와 초안이 여전히 참조하는 마스크는 유지하며, 사용되지 않는 마스크가 500 MB를 넘으면 스스로를 제안합니다.
• voice_description_at_label은 각 보이스 RefMod의 저장된 설명을 <Audio n>: 레이블 바로 뒤에 기록합니다.
• 새 RefMod는 1024 px 대신 768 px 짧은 변을 기본값으로 사용합니다.
• 내장 가이드에 마스크 편집에 관한 파트 E가 추가되었고, README의 릴리스 노트는 별도의 CHANGELOG.md로 옮겨졌습니다.

설치

이 팩은 ComfyUI 0.30.0 이상과 일반적인 H3 체크포인트가 필요합니다. 텍스트와 키프레임 작업에는 fl2va, 참조 모드에는 ref2va를 사용합니다. 비디오와 오디오 디코딩은 PyAV를 통해 이루어지며, 정상적으로 동작하는 ComfyUI 설치라면 이미 갖추고 있습니다.

cd ComfyUI/custom_nodes
git clone https://github.com/Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder

이후 ComfyUI를 완전히 재시작한 다음, 노드 메뉴에서 MiniMax H3를 검색하세요. 이 팩은 ComfyUI Manager에서 "Fantastic H3 Prompt Builder"를 검색해 설치할 수도 있습니다.

저장소: Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder
RefMods 가이드: REFMODS.md
변경 로그: CHANGELOG.md
베이스 모델: Comfy-Org/MiniMax-H3