Load Video (Upload) 🎥🅥🅗🅢 (LoadVideoUpload) - ComfyUI-VideoHelperSuite

Load Video (Upload) 🎥🅥🅗🅢 노드는 비디오 처리 워크플로의 시작점 역할을 합니다.

Load Video (Upload) 🎥🅥🅗🅢 노드는 Video Helper Suite 툴킷의 핵심 구성 요소로, 사용자가 업로드한 비디오 파일을 ComfyUI 워크플로에 로드하는 데 특화되어 있습니다. 비디오 파일을 읽고 이를 일련의 개별 이미지 프레임으로 분해하여 후속 이미지 처리, AI 생성 또는 비디오 편집 작업을 가능하게 합니다.

노드 기능

이 노드의 주요 기능은 비디오 처리 파이프라인의 시작점 역할을 하는 것입니다. 비디오에서 시각적 프레임 시퀀스를 추출할 뿐만 아니라 오디오 트랙을 분리하고 비디오 메타데이터를 제공하여 후속 프레임 분석, 콘텐츠 수정, 스타일 변환 또는 재합성 작업을 위한 기본 재질을 제공합니다. 사용자는 다양한 파라미터를 통해 비디오 로딩 과정을 세밀하게 제어할 수 있습니다.

노드 파라미터 설명 - Load Video (Upload) 🎥🅥🅗🅢

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`video`	콤보	예	-	-	: 로드할 비디오 파일을 선택합니다. 이 목록은 입력 디렉토리 내 지원되는 모든 비디오 형식 파일을 자동으로 스캔하여 표시합니다.
`meta_batch`	VHS_BATCHMANAGER	아니요	-	-	: (선택 사항) 복잡한 워크플로에서 여러 비디오 또는 이미지 시퀀스의 로딩 및 처리를 조정하기 위해 배치 매니저에 연결합니다.
`vae`	VAE	아니요	-	-	: (선택 사항) VAE 모델을 연결하면, 노드가 픽셀 이미지 대신 비디오 프레임의 잠재 공간 표현을 직접 출력합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`force_rate`	콤보	예	0	0 - 60 (간격: 1)	: 출력 프레임 시퀀스의 프레임 속도를 강제로 설정합니다. 범위 0-60, 간격 1. 0으로 설정하면 비디오 원본 프레임 속도를 사용합니다.
`custom_width`	INT	예	0	0 - DIMMAX	: 출력 이미지의 너비를 사용자 정의합니다. 범위 0부터 DIMMAX까지. 0으로 설정하면 비디오 원본 너비를 유지합니다.
`custom_height`	INT	예	0	0 - DIMMAX	: 출력 이미지의 높이를 사용자 정의합니다. 범위 0부터 DIMMAX까지. 0으로 설정하면 비디오 원본 높이를 유지합니다.
`frame_load_cap`	INT	예	0	0 - BIGMAX (간격: 1)	: 로드할 최대 프레임 수를 제한합니다. 범위 0부터 BIGMAX까지, 간격 1. 0으로 설정하면 모든 프레임을 로드합니다.
`skip_first_frames`	INT	예	0	0 - BIGMAX (간격: 1)	: 비디오 시작 부분에서 지정된 수의 프레임을 건너뜁니다. 범위 0부터 BIGMAX까지, 간격 1.
`select_every_nth`	INT	예	1	1 - BIGMAX (간격: 1)	: N번째 프레임마다 한 프레임을 로드합니다. 범위 1부터 BIGMAX까지, 간격 1. 프레임 속도를 낮추거나 키프레임을 추출하는 데 사용됩니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
IMAGE	알 수 없음	: 비디오의 프레임 시퀀스를 출력하며, 각 프레임은 하나의 이미지입니다.
frame_count	INT	: 로드된 비디오 프레임의 총 개수를 출력합니다.
audio	AUDIO	: 비디오에서 분리된 오디오 데이터를 출력합니다.
video_info	VHS_VIDEOINFO	: 비디오 메타데이터(치수, 프레임 수, 프레임 속도)를 제공합니다.

사용 시나리오

대표적인 사용 시나리오는 다음과 같습니다: Stable Diffusion과 같은 이미지 생성 모델을 위해 프레임 내 인페인팅 또는 스타일화를 수행할 비디오 소스를 준비하는 경우, 비디오에서 키프레임을 추출하여 분석하는 경우, 비디오와 오디오를 분리하여 각각 처리하는 경우, 또는 배치 처리 워크플로에서 여러 비디오 클립을 관리하는 경우 등입니다. 이 노드는 다양한 일반적인 비디오 형식을 지원하며, 비디오 기반 비디오 생성 워크플로를 구축하는 첫 번째 단계입니다.

Load Video (Upload) 🎥🅥🅗🅢 노드 소스 코드 링크

Load Video (Upload) 🎥🅥🅗🅢 노드는 ComfyUI-VideoHelperSuite 노드 패키지에서 제공됩니다.

Load Video (Upload) 🎥🅥🅗🅢(LoadVideoUpload)