nkxx188/ComfyUI-MiniMaxH3-Easy

해결하는 문제

이 프로젝트는 ComfyUI 내에서 MiniMax H3 비디오 생성 모델을 사용하기 위한 단순화된 고수준 인터페이스를 제공합니다. 복잡한 다중 노드 설정을 대체하여, 프롬프트, 미디어 입력, 모델 설정을 관리하는 컴팩트한 "Easy" 노드를 제공하며, 샘플링 및 후처리를 위한 ComfyUI 생태계와의 호환성을 유지합니다.

작동 방식

시스템의 핵심은 텍스트-비디오, 이미지-비디오, 참조 기반 비디오 생성의 핵심 로직을 처리하는 주요 "Easy" 노드입니다.

• 미디어 처리: 이미지, 비디오, 오디오를 하나의 입력에 연결할 수 있는 고유한 멀티링크 Media 포트를 사용합니다. 노드는 이를 개별적으로 번호 매기고 추적합니다.
• 프롬프트 작성: 연결된 미디어를 참조하는 @ 참조와 대화/가사용 # 대화 블록을 지원하는 구조화된 에디터를 제공하며, 이는 MiniMax H3에 필요한 특정 태그로 변환됩니다.
• 프롬프트 최적화: 모드 인식 가이드를 기반으로 외부 API(OpenAI, Gemini)를 사용해 프롬프트를 재작성하는 선택적 내장 도구가 있습니다. 생성 품질을 향상시킵니다.
• 모델 관리: 필요한 트랜스포머, 텍스트 인코더, VAE를 함께 제공하는 로더가 있지만, 사용자가 자신의 로더(포함 GGUF 변형)를 사용하고자 할 경우 "Model Bridge"도 제공됩니다.
• 이중 패스 워크플로우: 해상도 변경 시 일반적으로 발생하는 키프레임 불일치 문제를 방지하기 위해 고해상도 정밀화를 가능하게 하는 전용 2단계 조건 노드를 포함합니다.

대상 사용자

수십 개의 노드를 수동으로 구성하지 않고 MiniMax H3의 비디오 생성 기능을 사용하고 싶은 ComfyUI 사용자, 그리고 AI 비디오에서 참조 미디어와 대화를 정밀하게 제어해야 하는 크리에이터.

주요 특징

• 통합 미디어 포트: 여러 이미지, 비디오, 오디오 클립을 하나의 포트에 연결 가능하며, 구분 가능한 와이어 색상과 빠른 생성 메뉴를 제공합니다.
• @ 참조 에디터: 피커를 사용해 프롬프트 내에서 연결된 미디어를 쉽게 태그 지정할 수 있습니다.
• 대화 블록: 대화 및 가사를 생성하기 위한 전용 구문으로, 생성 중에도 유지됩니다.
• API 기반 프롬프트 최적화 도구: OpenAI 및 Gemini 통합 지원으로, 특정 H3 장면 가이드를 기반으로 프롬프트를 재작성합니다.
• 패스 2 정밀화: 해상도 변경을 위한 2단계 패스에 특화된 도구로, 구성과 타이밍을 유지합니다.
• 유연한 모델 로딩: 번들로드와 사용자 정의 모델 브리지 모두 지원하며, GGUF 및 safetensors 파일을 포함합니다.