Easy Apply IPAdapter (Regional) 노드: ComfyUI 지역 IPAdapter 적용(ipadapterApplyRegional)

Easy Apply IPAdapter (Regional) 노드는 참조 이미지와 선택적 마스크를 사용하여 어댑터가 결과에 영향을 미치는 위치와 방식을 제어하면서 Easy-Use 파이프라인에 IPAdapter를 적용합니다. 또한 포지티브/네거티브 프롬프트 텍스트와 이미지 및 프롬프트 구성 요소에 대한 독립적인 가중치 컨트롤을 허용합니다. 이 노드는 EasyUse/Adapter 카테고리에 있습니다.

설명

이 노드는 PIPE_LINE에 IPAdapter 기반 지역 가이드를 추가합니다. 단순한 전역 IPAdapter 적용과 달리, 지역 변형은 텍스트 프롬프트와 마스크를 제공할 수 있으므로 어댑터를 특정 영역에 타겟팅하거나 프롬프트 인식 지역 조건화에 사용할 수 있습니다. 이 노드는 업데이트된 파이프, 추가 사용을 위한 IPADAPTER_PARAMS 객체, 포지티브/네거티브 조건화 출력을 생성합니다.

입력

필수

• pipe (PIPE_LINE): 활성 모델, CLIP, VAE 및 기타 샘플러 상태를 포함하는 Easy-Use 파이프라인입니다. 이 노드는 새로 생성된 조건화 및 IPAdapter 파라미터로 이 파이프를 업데이트합니다.
• image (IMAGE): IPAdapter에서 사용하는 참조 이미지입니다. 어댑터는 이 이미지에서 시각적 스타일/콘텐츠 정보를 학습하거나 추출하여 생성에 적용합니다.
• positive (STRING, 기본값: ""): 지역 IPAdapter 적용에 사용되는 포지티브 프롬프트 텍스트입니다. 이 텍스트는 인코딩되어 포지티브 조건화 출력에 결합됩니다.
• negative (STRING, 기본값: ""): 지역 IPAdapter 적용에 사용되는 네거티브 프롬프트 텍스트입니다. 이 텍스트는 인코딩되어 네거티브 조건화 출력에 결합됩니다.
• image_weight (FLOAT, 기본값: 1, 범위: -1 ~ 3, 간격: 0.05): 참조 이미지가 결과에 얼마나 강하게 영향을 미치는지 제어합니다. 음수 값은 이미지 영향을 반전하거나 상쇄하는 데 사용할 수 있습니다.
• prompt_weight (FLOAT, 기본값: 1, 범위: 0 ~ 10, 간격: 0.05): 제공된 프롬프트 텍스트가 결과에 얼마나 강하게 영향을 미치는지 제어합니다.
• weight_type (COMBO): IPAdapter 가중치가 적용되는 방식을 결정합니다. 사용 가능한 옵션은 이징 곡선 또는 스타일/구성 가중치 모드와 같은 표준 IPAdapter 가중치 동작을 따릅니다.
• start_at (FLOAT, 기본값: 0, 범위: 0 ~ 1, 간격: 0.001): IPAdapter 효과가 시작되는 디노이즈 단계입니다. 0 값은 샘플링 프로세스 시작부터 적용을 시작합니다.
• end_at (FLOAT, 기본값: 1, 범위: 0 ~ 1, 간격: 0.001): IPAdapter 효과가 중지되는 디노이즈 단계입니다. 1 값은 샘플링 프로세스가 끝날 때까지 효과를 유지합니다.

선택

• mask (MASK, 선택): IPAdapter가 적용될 영역을 정의하는 마스크입니다. 제공되면 어댑터 효과가 마스크에 따라 제한되거나 집중됩니다. 생략하면 어댑터가 전역적으로 또는 기본 지역 동작으로 적용됩니다.
• optional_ipadapter_params (IPADAPTER_PARAMS, 선택): 위젯 설정을 재정의하거나 보강하기 위해 전달할 수 있는 기존 IPAdapter 파라미터입니다. 어댑터 구성을 연결하거나 재사용할 때 유용합니다.

출력

• PIPE_LINE: IPAdapter 지역 조건화 및 파라미터가 적용된 업데이트된 Easy-Use 파이프라인으로, 샘플러 또는 추가 파이프라인 노드에 전달할 준비가 되었습니다.
• IPADAPTER_PARAMS: 이 노드에서 생성된 IPAdapter 파라미터 객체로, 다른 IPAdapter 호환 노드에서 재사용할 수 있습니다.
• CONDITIONING: 인코딩된 포지티브 프롬프트와 지역 IPAdapter 영향을 포함하는 포지티브 조건화 출력입니다.
• CONDITIONING: 인코딩된 네거티브 프롬프트와 해당 IPAdapter 네거티브 영향을 포함하는 네거티브 조건화 출력입니다.

사용 참고 사항

• 해당 프롬프트 텍스트가 기여하는 것을 원하지 않으면 positive 또는 negative를 비워 두세요.
• image_weight와 prompt_weight를 독립적으로 사용하여 텍스트 프롬프트와 시각적 참조의 균형을 맞추세요.
• IPAdapter 영향력을 이미지의 일부로만 제한하려면 mask를 제공하세요. 마스크가 제공되지 않으면 이 노드는 공간 영역 제한 없이 어댑터를 적용합니다.
• start_at / end_at 범위를 사용하면 디노이즈 스케줄의 특정 구간에서만 어댑터를 적용할 수 있습니다. 이를 통해 초기에는 구조를 보존하고 후기에는 미세한 디테일을 추가하는 데 도움이 됩니다.
• 다른 노드나 이전 호출에서 이미 IPADAPTER_PARAMS 객체를 가지고 있다면 optional_ipadapter_params에 전달하여 고급 설정을 유지하세요.