# SDPose关键点提取器节点

此节点使用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帧格式的关键点（canvas_width, canvas_height, people）。输出包含检测到的人物，每个人物带有关键点坐标数组(x, y)及其对应的置信度分数。 | POSE_KEYPOINT |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SDPoseKeypointExtractor/zh.md)

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