Easy Apply IPAdapter (ipadapterApply) - ComfyUI-Easy-Use

설명

Easy Apply IPAdapter 노드(ipadapterApply)는 IP-Adapter를 diffusion 모델에 한 번에 적용합니다. 일반적인 IPAdapter pipeline(프리셋 선택, 선택적 LoRA 강도, 공급자, 스케줄링, 캐싱, 선택적 어텐션 마스크)을 래핑하여 샘플러에 직접 전달할 수 있는 수정된 모델을 반환합니다.

이 노드는 EasyUse/Adapter 카테고리에 속합니다.

입력

이름	타입	필수	기본값	설명
`model`	`MODEL`	예	—	IPAdapter를 적용할 diffusion 모델입니다.
`image`	`IMAGE`	예	—	어댑터에서 사용하는 참조 이미지입니다. FaceID 프리셋의 경우 얼굴이 포함되어야 합니다.
`preset`	`COMBO`	예	—	사용할 IPAdapter 프리셋을 선택합니다. 선택 가능한 항목은 설치된 프리셋/모델에 따라 달라집니다.
`lora_strength`	`FLOAT`	예	0.6	선택된 프리셋에서 사용하는 LoRA의 강도입니다. LoRA가 없는 프리셋에서는 이 값을 무시합니다.
`provider`	`COMBO`	예	`CUDA`	어댑터 구성 요소의 실행 공급자입니다. 옵션: `CPU`, `CUDA`, `ROCM`, `DirectML`, `OpenVINO`, `CoreML`.
`weight`	`FLOAT`	예	1.0	전체 IPAdapter 가중치입니다. 범위: -1~3, 간격 0.05. 0으로 설정하면 어댑터의 영향이 비활성화됩니다.
`weight_faceidv2`	`FLOAT`	예	1.0	선택된 프리셋이 FaceID v2일 때 사용되는 별도의 가중치입니다. 범위: -1~5, 간격 0.05. FaceID v2가 아닌 프리셋에서는 무시됩니다.
`start_at`	`FLOAT`	예	0.0	IPAdapter 적용이 시작되는 스텝 비율입니다. 범위: 0~1, 간격 0.001.
`end_at`	`FLOAT`	예	1.0	IPAdapter 적용이 중지되는 스텝 비율입니다. 범위: 0~1, 간격 0.001.
`cache_mode`	`COMBO`	예	`all`	호출 사이에 캐시할 구성 요소를 제어합니다. 옵션: `insightface only`, `clip_vision only`, `ipadapter only`, `all`, `none`.
`use_tiled`	`BOOLEAN`	예	`false`	메모리 사용량을 줄이기 위해 타일드 IPAdapter 적용을 활성화합니다. 큰 이미지에 유용하지만 결과가 약간 다를 수 있습니다.
`attn_mask`	`MASK`	아니요	—	IPAdapter 어텐션을 제한하는 선택적 마스크입니다.
`optional_ipadapter`	`IPADAPTER`	아니요	—	프리셋에서 새로 만들지 않고 재사용할 기존 IPAdapter 객체입니다.

출력

타입	설명
`MODEL`	IPAdapter가 적용된 입력 모델입니다. 어댑터가 활성화된 상태로 생성하려면 샘플러에서 사용하세요.
`IMAGE`	변경 없이 그대로 전달되는 원본 입력 참조 이미지입니다.
`MASK`	`attn_mask`에 제공된 어텐션 마스크가 변경 없이 그대로 전달됩니다. 마스크가 제공되지 않은 경우 `None`입니다.
`IPADAPTER`	이 노드에서 생성되거나 사용된 IPAdapter 객체로, 다른 어댑터 노드에서 재사용할 수 있습니다.

사용 시 참고사항

기본 스케줄링(start_at=0.0, end_at=1.0)에서는 IPAdapter가 전체 denoising 범위에 걸쳐 활성화됩니다. end_at을 낮추면 초기 스텝에서만 적용되고, start_at을 높이면 나중에만 적용됩니다.
weight는 주요 강도 제어값입니다. weight_faceidv2는 FaceID v2 프리셋을 위한 추가적인 별도 강도 값입니다.
lora_strength는 선택된 프리셋이 로드하는 LoRA를 제어합니다. FaceID 스타일 프리셋에는 일반적으로 이러한 LoRA가 포함되지만, LoRA가 포함되지 않은 프리셋에서는 이 매개변수가 효과가 없습니다.
cache_mode는 배치 실행에 유용합니다. all은 재사용 가능한 모든 구성 요소를 캐시하고, none은 캐싱을 비활성화하여 리소스를 더 빨리 해제합니다.
use_tiled는 고해상도 이미지에서 메모리 부족 오류를 방지하는 데 도움이 됩니다. 타일링은 어텐션 동작을 변경할 수 있으므로 출력 품질이 중요하다면 결과를 비교해 보세요.
IMAGE 및 MASK 출력은 체이닝을 위해 제공되는 패스스루 값이며, 생성된 이미지나 마스크가 아닙니다.
optional_ipadapter를 제공하면 이 노드는 새로 만들지 않고 이미 구성된 IPAdapter를 재사용할 수 있습니다.

Easy Apply IPAdapter(ipadapterApply)

ipadapter Apply

설명

입력

출력

사용 시 참고사항

댓글