> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# SDPoseFaceBBoxes - ComfyUI Built-in Node Documentation

> Complete documentation for the SDPoseFaceBBoxes node in ComfyUI. Learn its inputs, outputs, parameters and usage.

SDPoseFaceBBoxes 节点处理姿态关键点数据，用于检测并生成人脸周围的边界框。它会分析每一帧中每个人的二维面部关键点，基于这些点计算边界框，并可调整框的大小和形状。生成的边界框格式与 SDPose 工作流中的其他节点（如 SDPoseKeypointExtractor）兼容。

## 输入

| 参数             | 描述                                     | 数据类型           | 是否必需 | 范围         |
| -------------- | -------------------------------------- | -------------- | ---- | ---------- |
| `keypoints`    | 包含每帧检测到的人体及其身体/面部关键点信息的姿态关键点数据。        | POSE\_KEYPOINT | 是    | -          |
| `scale`        | 每个检测到人脸周围边界框面积的乘数。值越大，生成的框越大。（默认值：1.5） | FLOAT          | 否    | 1.0 - 10.0 |
| `force_square` | 扩展较短的边界框轴，使裁剪区域始终为正方形。（默认值：True）       | BOOLEAN        | 否    | -          |

**注意：** `keypoints` 输入必须采用 SDPoseKeypointExtractor 等节点生成的特定格式，包含 `canvas_height`、`canvas_width` 以及每个人员的 `face_keypoints_2d` 数据。

## 输出

| 输出名称     | 描述                                                                                                           | 数据类型        |
| -------- | ------------------------------------------------------------------------------------------------------------ | ----------- |
| `bboxes` | 每帧的人脸边界框列表。每个边界框由其左上角坐标（`x`、`y`）、`width`（宽度）和 `height`（高度）定义。此输出与 SDPoseKeypointExtractor 节点的 `bboxes` 输入兼容。 | BOUNDINGBOX |

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

***

**Source fingerprint (SHA-256):** `bffbcddb882f6743a6cace6a4884fa5a257b746897c79ba9260c15260fab874e`