HunyuanVideo Encode Keyframes To Cond (HunyuanVideoEncodeKeyframesToCond) - ComfyUI-KJNodes

HunyuanVideo Encode Keyframes To Cond 노드는 시작 프레임과 종료 프레임의 이미지 입력을 받아, 지정된 변분 자동 인코더(VAE)를 통해 이를 잠재 공간으로 인코딩합니다.

HunyuanVideo Encode Keyframes To Cond는 비디오 생성 워크플로를 위해 설계된 노드입니다. 핵심 기능은 시작 프레임과 종료 프레임을 처리하여 잠재 공간 표현으로 인코딩하고, 비디오 모델을 안내하는 데 사용될 조건화 정보를 생성하는 것입니다. 이 노드는 비디오 시퀀스 생성을 위한 초기 시각적 및 조건적 기반을 제공하는 것을 목표로 합니다.

노드 기능

이 노드는 시작 프레임과 종료 프레임의 이미지 입력을 받아, 지정된 변분 자동 인코더(VAE)를 통해 이를 잠재 공간으로 인코딩합니다. 고해상도 이미지를 처리하기 위한 타일드 인코딩을 지원하며, 시간 차원에서의 인코딩 블록 크기와 중첩 영역을 설정할 수 있습니다. 이는 비디오 VAE를 처리할 때 특히 중요합니다. 노드는 수정된 모델, 긍정 조건화 및 네거티브 조건화 정보, 그리고 인코딩된 잠재 표현을 포함하는 LATENT 객체를 출력합니다.

노드 파라미터 설명 - HunyuanVideo Encode Keyframes To Cond

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`model`	MODEL	예	-	-	model (입력 파라미터): 비디오 생성에 사용되는 모델입니다.
`positive`	CONDITIONING	예	-	-	positive (입력 파라미터): 생성을 안내하는 긍정 조건화 정보입니다.
`vae`	VAE	예	-	-	vae (입력 파라미터): 이미지를 잠재 공간으로 인코딩하는 데 사용할 변분 자동 인코더를 입력합니다.
`start_frame`	IMAGE	예	-	-	start_frame (입력 파라미터): 비디오 시퀀스의 시작 키프레임 이미지를 입력합니다.
`end_frame`	IMAGE	예	-	-	end_frame (입력 파라미터): 비디오 시퀀스의 종료 키프레임 이미지를 입력합니다.
`negative`	CONDITIONING	아니요	-	-	negative (입력 파라미터): 선택적 네거티브 조건화 정보입니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`num_frames`	INT	예	33	2 - 4096 (간격: 1)	num_frames (입력 파라미터): 생성할 총 프레임 수를 지정합니다. 범위는 2부터 4096까지이며 간격은 1입니다.
`tile_size`	INT	예	512	64 - 4096 (간격: 64)	tile_size (입력 파라미터): 이미지 타일드 인코딩 시 각 타일의 크기를 설정합니다. 범위는 64부터 4096까지이며 간격은 64입니다.
`overlap`	INT	예	64	0 - 4096 (간격: 32)	overlap (입력 파라미터): 이미지 타일드 인코딩 시 타일 간 중첩 픽셀 수를 설정합니다. 범위는 0부터 4096까지이며 간격은 32입니다.
`temporal_size`	INT	예	64	8 - 4096 (간격: 4)	비디오 VAE에만 사용됨: 한 번에 인코딩할 프레임 수입니다.
`temporal_overlap`	INT	예	8	4 - 4096 (간격: 4)	비디오 VAE에만 사용됨: 중첩할 프레임 수입니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
model	MODEL	model (출력 파라미터): 키프레임 조건을 받을 준비가 된 수정된 모델을 출력합니다.
positive	CONDITIONING	positive (출력 파라미터): 처리된 긍정 조건화 정보를 출력합니다.
negative	CONDITIONING	negative (출력 파라미터): 처리된 네거티브 조건화 정보를 출력합니다.
latent	LATENT	latent (출력 파라미터): 시작 프레임과 종료 프레임을 인코딩하여 얻은 잠재 공간 표현을 출력합니다.

사용 시나리오

비디오 보간 또는 키프레임으로부터 비디오 시퀀스를 생성하는 워크플로에서, 사용자는 이 노드를 모델 로딩 노드 이후에 배치할 수 있습니다. 시작 및 종료 키프레임 이미지를 연결하고 총 프레임 수를 설정함으로써, 이 노드는 후속 비디오 생성 모델에 필요한 조건 입력과 초기 잠재 상태를 준비하여 모델이 일관된 중간 프레임을 생성하도록 안내합니다.

주의사항

이 노드는 입력 이미지의 크기에 요구 사항이 있으며, 크기를 8의 배수로 자동 조정합니다. temporal_size 및 temporal_overlap 파라미터는 사용하는 VAE가 비디오 VAE인 경우에만 적용되며, 시간 차원에서의 인코딩 방법을 제어합니다.

HunyuanVideo Encode Keyframes To Cond 노드 소스 코드 링크

HunyuanVideo Encode Keyframes To Cond 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

HunyuanVideo Encode Keyframes To Cond(HunyuanVideoEncodeKeyframesToCond)