# SDPoseKeypointExtractor

SDPoseKeypointExtractor 노드는 SDPose 모델을 사용하여 입력 이미지에서 사람의 포즈 키포인트를 감지합니다. 전체 이미지 또는 경계 상자로 정의된 특정 영역을 처리할 수 있으며, 각 사람의 좌표와 각 키포인트의 신뢰도 점수를 포함하는 OpenPose 형식으로 감지된 키포인트를 출력합니다.

## 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 |
| --- | --- | --- | --- | --- |
| `model` | 키포인트 감지에 사용되는 SDPose 모델입니다. `heatmap_head` 속성을 가진 모델이어야 하며, 특히 SDPose 저장소의 모델이어야 합니다. | MODEL | 예 | - |
| `vae` | 입력 이미지를 처리를 위해 잠재 공간으로 인코딩하는 데 사용되는 VAE 모델입니다. | VAE | 예 | - |
| `image` | 포즈 키포인트를 추출할 입력 이미지 또는 이미지 배치입니다. | IMAGE | 예 | - |
| `batch_size` | 전체 이미지 모드(즉, `bboxes`가 제공되지 않은 경우)에서 한 번에 처리할 이미지 수입니다. 이를 통해 처리 속도를 높일 수 있습니다. (기본값: 16) | INT | 아니요 | 1 ~ 10000 |
| `bboxes` | 더 정확한 감지를 위한 선택적 경계 상자입니다. 다중 인물 감지에 필요합니다. 제공된 경우 노드는 각 지정된 영역에서 키포인트를 추출합니다. | BOUNDINGBOX | 아니요 | - |

**매개변수 제약 조건:**
*   `model` 입력은 특정 SDPose 모델이어야 합니다. 제공된 모델에 `heatmap_head` 속성이 없으면 노드에서 오류가 발생합니다.
*   노드는 `bboxes` 입력에 따라 두 가지 모드로 작동합니다:
    1.  **경계 상자 모드:** `bboxes`가 제공되면 각 지정된 영역을 개별적으로 처리합니다. 단일 이미지에서 여러 사람을 감지하는 데 필요합니다.
    2.  **전체 이미지 모드:** `bboxes`가 제공되지 않으면 전체 이미지를 배치로 처리합니다. `batch_size` 매개변수는 이 모드에서만 적용됩니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| --- | --- | --- |
| `keypoints` | OpenPose 프레임 형식(캔버스 너비, 캔버스 높이, 사람)의 키포인트입니다. 출력에는 감지된 사람들이 포함되며, 각 사람은 키포인트 좌표(x, y) 배열과 해당 신뢰도 점수를 가집니다. | POSE_KEYPOINT |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SDPoseKeypointExtractor/ko.md)

---
**Source fingerprint (SHA-256):** `7903b51c9137aa08bb8843362740fcf93cea9c09d142bd1db3b5eee945c853e4`