Skip to main content
ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.이 가이드의 워크플로는 워크플로 템플릿에서 확인할 수 있습니다. 템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:
  1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
  2. 일부 노드가 시작 시 가져오기에 실패함
SDPose는 이미지와 비디오에서 사람의 키포인트를 추출하는 전신 포즈 감지 모델입니다. RT-DETRv4 객체 감지기와 결합하여 다중 인물 감지 및 OOD(Out-of-Domain) 포즈 추정을 지원하므로 애니메이션 파이프라인, 포즈 기반 생성 및 모션 추적 워크플로에 다용도로 활용할 수 있습니다. SDPose + RT-DETRv4는 ComfyUI에 기본 지원됩니다 (PR #12748). 모델 가중치는 Hugging Face에서 제공됩니다. SDPose 모델 on Hugging Face | RT-DETRv4 논문 (arXiv) | SDPose 논문 (arXiv)

주요 강점

  • 전신 키포인트: 통합 모델에서 몸, 손, 얼굴, 발 키포인트를 감지합니다
  • 다중 인물 지원: 단일 이미지 또는 비디오에서 여러 사람을 감지하고 라벨을 붙입니다
  • 출력 구성 가능: 시각화할 신체 부위(몸, 손, 얼굴, 발)를 선택하고 스틱/폰트 크기를 조정할 수 있습니다
  • 바운딩 박스 감지: 임계값과 클래스 선택 조정이 가능한 객체 감지 포함
  • 이미지 및 비디오 지원: 단일 이미지, 비디오, OOD 포즈 추정을 위한 전용 워크플로
제한 사항: 감지 정확도는 이미지 해상도와 피사체 가시성에 따라 달라집니다. 매우 가려져 있거나 아주 작은 피사체는 키포인트가 적게 생성될 수 있습니다.

SDPose 워크플로

사용 사례에 따라 네 가지 워크플로를 사용할 수 있습니다:

1. 워크플로 다운로드

ComfyUI를 최신 버전으로 업데이트한 다음 워크플로 -> 템플릿 탐색으로 이동하여 유틸리티 카테고리에서 SDPose 워크플로를 찾으세요.

SDPose: 이미지 다중 인물 감지

이미지를 업로드하여 사람의 포즈를 감지하세요. 한 명의 개인과 같은 장면 내 여러 명을 모두 감지할 수 있습니다. SDPose 이미지 다중 인물 감지 워크플로 미리보기

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “SDPose: Image Multi-Person Detection” 검색
입력 자료 이 파일을 해당하는 LoadImage 노드에 업로드하세요:

group_photo.png

LoadImage 노드 679 · group_photo.png
입력 이미지

SDPose: 비디오 다중 인물 감지

비디오를 업로드하여 사람의 포즈를 감지합니다. 동일한 장면에서 단일 인물과 여러 사람 모두를 감지할 수 있습니다. SDPose 비디오 다중 인물 감지 워크플로 미리보기

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “SDPose: Video Multi-Person Detection” 검색
입력 자료 이 파일을 해당하는 LoadVideo 노드에 업로드하세요:

man_playing_violin.mp4

LoadVideo 노드 694 · man_playing_violin.mp4

SDPose-OOD: 이미지를 포즈 맵으로 변환

이미지를 업로드하여 SDPose-OOD 모델을 사용해 포즈 키포인트를 추출하고 해당 포즈 맵을 생성합니다. SDPose-OOD 이미지를 포즈 맵으로 변환하는 워크플로 미리보기

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON을 다운로드하거나 템플릿 라이브러리에서 “SDPose-OOD: Image to Pose Map”을 검색하세요.
입력 자료 해당 LoadImage 노드에 이 파일을 업로드하세요:

dancer.png

LoadImage 노드 667 · dancer.png
출력 예시
입력 이미지SDPose-OOD 이미지를 포즈 맵으로 변환한 출력 예시

SDPose-OOD: 비디오를 포즈 맵으로 변환

비디오를 업로드하여 포즈 키포인트를 추출하고 포즈 맵을 생성하세요. 이 워크플로는 다중 인물 감지를 지원하며, 향상된 SDPose 모델을 사용하여 정확한 전신 특징 추출을 수행합니다. SDPose-OOD 비디오-포즈 맵 변환 워크플로 미리보기

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “SDPose-OOD: Video to Pose Map” 검색
입력 자료 이 파일을 해당 LoadVideo 노드에 업로드하세요:

man_in_the_rain.mp4

LoadVideo 노드 679 · man_in_the_rain.mp4
예시 출력

2. 모델 다운로드

SDPose 및 RT-DETRv4 모델 체크포인트는 Comfy-Org SDPose 모델 저장소에 호스팅되어 있습니다. 체크포인트 (SDPose 모델): diffusion_models (RT-DETRv4 검출기): 다음 디렉터리 구조에 배치하세요:

3. 워크플로 사용하기

다중 인물 (이미지)

  • 입력: Load Image 노드를 통해 이미지를 불러옵니다. 한 명 이상의 사람이 포함된 이미지를 사용합니다 (예: group_photo.png).
  • 감지: Image to Pose Map (SDPose Multi-Person) 서브그래프가 이미지를 처리하여 다음을 출력합니다:
    • IMAGE: 이미지 위에 오버레이된 포즈 스켈레톤 시각화
    • keypoints: 원시 전신 키포인트 데이터
    • bboxes: 바운딩 박스 좌표
  • 그리기 옵션: 그릴 신체 부위를 구성합니다:
    • draw_body, draw_hands, draw_face, draw_feet: 표시 여부 전환
    • stick_width, face_point_size: 시각적 스타일 조정
    • score_threshold: 키포인트 표시를 위한 최소 신뢰도
  • 감지 옵션:
    • resize_type.longer_size: 감지 전에 더 긴 변의 크기를 조절합니다
    • max_detections: 감지할 최대 인원 수
    • detect_threshold: 감지 신뢰도 임계값
    • detect_class: 감지할 객체 클래스 (기본값: person)

다중 인물 (비디오)

이미지 워크플로와 동일하지만 비디오 프레임을 순차적으로 처리합니다. Load Video를 사용하여 비디오 파일을 불러오고 Save Video를 사용하여 결과를 내보냅니다.

OOD Image to Pose

SDPose 모델을 사용하여 이미지에서 바운딩 박스 시각화 없이 깨끗한 포즈 맵을 생성합니다. 한 이미지에서 스켈레톤 포즈를 추출하여 다른 이미지에 적용하려는 스타일 전송에 유용합니다.

OOD Video to Pose Map

비디오에서 프레임별 포즈 맵을 생성합니다. 출력은 각 프레임에 추출된 포즈 스켈레톤이 포함된 비디오 파일로, 후속 애니메이션이나 ControlNet 워크플로에 적합합니다.

서브그래프 정보

이 워크플로는 모듈식 처리를 위해 서브그래프 노드를 사용합니다. 서브그래프 문서를 확인하여 워크플로를 사용자 정의하고 확장하는 방법을 알아보세요.

추가 참고 사항

  • 모델 디렉토리: SDPose 체크포인트는 models/checkpoints/에, RT-DETRv4 감지기는 models/diffusion_models/에 넣습니다.
  • 입력 이미지 예시: group_photo.png 파일은 워크플로 템플릿의 input/ 디렉토리에서 테스트용으로 제공됩니다.
  • 키포인트 출력: POSE_KEYPOINT 유형은 조건부 생성을 위해 포즈 데이터를 허용하는 다운스트림 노드에 연결할 수 있습니다.
  • 업데이트 필수: SDPose + RT-DETRv4 지원은 최근 ComfyUI 버전에서 사용 가능합니다. ComfyUI가 최신 상태인지 확인하세요.