Easy Apply IPAdapter (FaceID Kolors) (ipadapterApplyFaceIDKolors) - ComfyUI-Easy-Use

이 노드는 Kolors 프리셋으로 IPAdapter FaceID를 적용하기 위한 원스톱 래퍼입니다. 일반적인 FaceID 설정(얼굴 임베딩 추출, FaceID LoRA 스케일링, 임베딩 구성, IPAdapter 어텐션 주입)을 단일 Easy Apply 노드로 묶습니다. 프리셋이 FACEID PLUS KOLORS로 고정되어 있어, Kolors 호환 모델로 얼굴 조건화 생성에 바로 사용할 수 있습니다.

입력

입력	유형	기본값	설명
`model`	MODEL	없음	IPAdapter 조건화를 적용할 diffusion 모델입니다.
`image`	IMAGE	없음	입력 얼굴 이미지입니다. InsightFace 얼굴 임베딩 추출과 CLIP vision 특징 추출에 모두 사용됩니다.
`preset`	COMBO	`FACEID PLUS KOLORS`	고정 프리셋입니다. `FACEID PLUS KOLORS`만 사용할 수 있습니다.
`lora_strength`	FLOAT	`0.6`	IPAdapter 조건화 이전에 적용되는 FaceID LoRA의 강도입니다. 값이 낮을수록 정체성 전달이 약해지고, 값이 높을수록 얼굴이 더 두드러지지만 아티팩트가 발생할 수 있습니다.
`provider`	COMBO	`CUDA`	InsightFace 얼굴 분석을 위한 실행 공급자입니다. 옵션: `CPU`, `CUDA`, `ROCM`, `DirectML`, `OpenVINO`, `CoreML`. 호환 가능한 가속 기능이 없을 때는 `CPU`를 사용하세요.
`weight`	FLOAT	`0.8`	IPAdapter 조건화의 전체 가중치입니다. 범위: `-1` ~ `3`.
`weight_faceidv2`	FLOAT	`1`	FaceID v2 임베딩 구성 요소의 가중치입니다. 범위: `-1` ~ `5`.
`weight_kolors`	FLOAT	`0.8`	Kolors 임베딩 구성 요소의 가중치입니다. 범위: `-1` ~ `5`.
`weight_type`	COMBO	없음	UNet 전체에 IPAdapter 어텐션을 적용할 때 사용되는 가중치 모드입니다. 정확한 옵션은 기본 IPAdapter 구현에서 제공됩니다.
`combine_embeds`	COMBO	없음	FaceID와 Kolors/CLIP 임베딩을 결합하는 방식입니다. 옵션: `concat`, `add`, `subtract`, `average`, `norm average`.
`start_at`	FLOAT	`0`	IPAdapter 영향 구간의 시작입니다. 범위: `0` ~ `1`.
`end_at`	FLOAT	`1`	IPAdapter 영향 구간의 끝입니다. 범위: `0` ~ `1`.
`embeds_scaling`	COMBO	없음	임베딩이 어텐션에 주입되는 방식을 제어합니다. 옵션: `V only`, `K+V`, `K+V w/ C penalty`, `K+mean(V) w/ C penalty`.
`cache_mode`	COMBO	`all`	호출 간 캐시할 항목입니다. 옵션: `insightface only`, `clip_vision only`, `ipadapter only`, `all`, `none`.
`use_tiled`	BOOLEAN	`false`	타일드 처리를 활성화합니다. 더 큰 이미지로 작업할 때 VRAM 사용량을 줄일 수 있습니다.
`use_batch`	BOOLEAN	`false`	입력 이미지와 임베딩에 대한 배치 처리를 활성화합니다.
`sharpening`	FLOAT	`0`	IPAdapter 처리 중 적용되는 선명화 강도입니다. 범위: `0` ~ `1`.
`image_negative`	IMAGE	없음	선택적 네거티브 참조 이미지입니다. 네거티브 얼굴/임베딩 조건화로 사용됩니다.
`attn_mask`	MASK	없음	선택적 어텐션 마스크입니다. IPAdapter 효과를 잠재 데이터/이미지의 특정 영역으로 제한합니다.
`clip_vision`	CLIP_VISION	없음	선택적 CLIP Vision 모델입니다. 제공하지 않으면 노드는 프리셋/캐시된 모델 처리를 사용합니다.
`optional_ipadapter`	IPADAPTER	없음	선택적 IPAdapter 모델입니다. 내부 프리셋 설정 대신 외부에서 로드된 IPAdapter 모델을 제공할 때 사용합니다.

출력

소스에서 제공하는 노드 정의에는 출력 슬롯이 없습니다.

사용 참고 사항

preset 입력은 FACEID PLUS KOLORS로 고정되어 있으므로 일반적인 사용에서는 프리셋 전환이 필요하지 않습니다.
weight를 조정하기 전에 lora_strength를 먼저 튜닝하세요. 얼굴 정체성이 너무 약하면 lora_strength, weight 또는 weight_faceidv2를 높여 보세요. 출력이 과적합되거나 왜곡되어 보이면 먼저 lora_strength를 낮추세요.
start_at과 end_at은 IPAdapter가 활성화되는 디노이즈 구간을 제어합니다. 기본 전체 범위(0 ~ 1)는 조건화를 전체에 적용합니다. 더 좁은 구간은 정체성을 유지하면서 구성을 보존하는 데 도움이 될 수 있습니다.
cache_mode는 InsightFace, CLIP vision 및 IPAdapter 리소스의 캐싱을 제어합니다. all은 반복 생성에 편리하며, none은 입력이 자주 변경되어 오래된 캐시 특징이 문제가 될 수 있는 경우 더 안전합니다.
image_negative는 네거티브 얼굴 조건화를 위해 제공할 수 있으며, 원치 않는 얼굴 특징을 억제하는 데 도움이 될 수 있습니다.
attn_mask는 얼굴 조건화가 얼굴 영역과 같이 이미지의 특정 부분에만 영향을 주어야 할 때 유용합니다.
사용 가능한 하드웨어가 CUDA를 지원하지 않으면 provider를 CPU 또는 다른 적절한 공급자로 전환하세요. 그렇지 않으면 런타임 중 InsightFace 얼굴 분석이 실패할 수 있습니다.

Easy Apply IPAdapter (FaceID Kolors)(ipadapterApplyFaceIDKolors)

ipadapter Apply Face ID Kolors

입력

출력

사용 참고 사항

댓글