技能介绍

解决的问题

当图片进入业务链路后，常见的前置判断是：画面里有没有人脸、有几张脸、人脸在哪个位置、是否足够清晰和正面。若只用常规图像处理，很难同时拿到属性、姿态与质量指标；若直接调用人脸识别，又会引入不必要的身份比对成本。tencentcloud-faceid-detectface 面向这类“先检测、再判断”的场景，把腾讯云 IAI DetectFace 包装成一个可脚本化调用的技能。

如何工作

技能接收本地图片路径、Base64 或图片 URL，根据优先级选择输入方式，并可选返回多组结果：

人脸定位：返回 X、Y、Width、Height，便于后续裁剪或画框。
多人脸检测：通过 --max-face-num 控制最多检测数量，默认 1，最大 120。
人脸属性：开启 --need-face-attributes 后，可获取性别、年龄、笑容、魅力、眼镜、口罩、Pitch、Yaw、Roll 等信息。
质量检测：开启 --need-quality-detection 后，返回 Score、Sharpness、Brightness、Completeness，帮助判断是否适合入库或进入核身流程。

关键步骤通常是从图片输入开始，按需选择属性开关和质量开关，最终输出 JSON 结果。相比直接拼 SDK，这种方式把参数、默认值和返回字段固定在同一个技能入口里，方便在自动化流程中复用。

适用边界与注意点

该技能适合做图片级人脸检测、质量筛选和属性统计，不适合用于身份认证、1:1 比对或敏感个人信息长期留存。输入图片需满足腾讯云规格：支持 PNG、JPG、JPEG、BMP，Base64 后不超过 5MB，分辨率也有上下限；若图片模糊、遮挡严重或人脸过小，检测结果会受 --min-face-size 与质量分影响。使用属性与姿态字段时，应把它们理解为概率或启发式指标，而不是确定性事实。