// 腾讯云人脸检测(DetectFace)接口调用技能。当用户需要对图片进行人脸检测时，应使用此技能。可检测图片中的人脸位置（坐标、宽高），并可选返回人脸属性（性别、年龄、表情、魅力、眼镜、口罩、头发、姿态）和人脸质量信息（质量分、模糊分、光照分、遮挡分）。支持图片Base64和图片URL两种输入方式，支持同时检测多张人脸。
腾讯云稠密人脸关键点(AnalyzeDenseLandmarks)接口调用技能。当用户需要对人脸图片进行稠密关键点定位时，应使用此技能。可返回人脸框坐标，以及人脸各部位（眼睛、眉毛、嘴巴、鼻子、瞳孔、中轴线、下巴、眼袋、额头）的稠密轮廓关键点坐标。支持图片Base64和图片URL两种输入方式。
腾讯云人脸比对(CompareFace)接口调用技能。当用户需要对两张人脸图片进行相似度比对时，应使用此技能。基于腾讯云人脸识别服务，对两张图片中的人脸进行相似度比较，返回人脸相似度分数。支持图片Base64和图片URL两种输入方式，可用于判断两张人脸是否为同一人。
腾讯云人脸静态活体检测高精度版(DetectLiveFaceAccurate)接口调用技能。当用户需要对人脸图片进行防翻拍活体检测时，应使用此技能。相比普通静态活体检测，高精度版增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力，适用于移动端、PC端各类型场景的图片活体检验。支持图片Base64和图片URL两种输入方式。
腾讯云AI人脸防护盾(DetectAIFakeFaces)接口调用技能。当用户需要对人脸图片或视频进行防攻击检测时,应使用此技能。可针对性有效识别高仿真的AIGC换脸、高清翻拍、批量黑产攻击、水印等攻击痕迹,增强对图片和视频的防伪安全能力。支持图片Base64和视频Base64两种输入方式。
| name | tencentcloud-faceid-detectface |
| description | 腾讯云人脸检测(DetectFace)接口调用技能。当用户需要对图片进行人脸检测时，应使用此技能。可检测图片中的人脸位置（坐标、宽高），并可选返回人脸属性（性别、年龄、表情、魅力、眼镜、口罩、头发、姿态）和人脸质量信息（质量分、模糊分、光照分、遮挡分）。支持图片Base64和图片URL两种输入方式，支持同时检测多张人脸。 |
调用腾讯云人脸识别（IAI）DetectFace 接口，对请求图片进行人脸检测，获取人脸坐标、属性信息及质量信息。
核心能力：
官方文档：https://cloud.tencent.com/document/product/867/44989
请确保您委托本服务处理人脸等个人信息已获得个人信息主体合法、有效的同意或具备其他的合法性基础，本服务的相关具体事项以本服务官网所载服务协议约定为准。
当用户提出以下需求时触发此技能：
tencentcloud-sdk-python（通过 pip install tencentcloud-sdk-python 安装）TENCENTCLOUD_SECRET_ID：腾讯云API密钥IDTENCENTCLOUD_SECRET_KEY：腾讯云API密钥Key运行 scripts/main.py 脚本完成人脸检测。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --image | str | 与 --url 二选一 | 本地图片文件路径（自动转 Base64）或 Base64 字符串 |
| --url | str | 与 --image 二选一 | 图片的 URL 地址，优先级高于 --image |
| --max-face-num | int | 否 | 最多检测人脸数，默认 1，最大 120 |
| --min-face-size | int | 否 | 人脸最小尺寸（像素），只支持 34 和 20，默认 34 |
| --need-face-attributes | int | 否 | 是否返回人脸属性：0(不返回)/1(返回)，默认 0 |
| --need-quality-detection | int | 否 | 是否开启质量检测：0(关闭)/1(开启)，默认 0 |
| --face-model-version | str | 否 | 算法模型版本：2.0/3.0，默认 3.0 |
| --need-rotate-detection | int | 否 | 是否开启旋转识别：0(关闭)/1(开启)，默认 0 |
| --region | str | 否 | 腾讯云地域，默认 ap-guangzhou |
检测成功后返回 JSON 格式结果：
{
"ImageWidth": 640,
"ImageHeight": 480,
"FaceModelVersion": "3.0",
"FaceCount": 1,
"FaceInfos": [
{
"X": 100,
"Y": 80,
"Width": 200,
"Height": 220,
"FaceAttributesInfo": {
"Gender": 99,
"Age": 28,
"Expression": 0,
"Beauty": 60,
"Glass": false,
"Pitch": 2,
"Yaw": -5,
"Roll": 1,
"Mask": 0,
"Hair": {"Length": 1, "Bang": 0, "Color": 0}
},
"FaceQualityInfo": {
"Score": 88,
"Sharpness": 90,
"Brightness": 85,
"Completeness": {...}
}
}
],
"RequestId": "xxx"
}
| 字段 | 说明 |
|---|---|
| Gender | 性别：0(女性) ~ 100(男性)，大于 50 为男性 |
| Age | 年龄：0~100 |
| Expression | 笑容：0(严肃) ~ 100(大笑) |
| Beauty | 魅力：0~100 |
| Glass | 是否戴眼镜：true/false |
| Mask | 口罩：0(无口罩) |
| Pitch | 俯仰角：上下点头，-30°~30° |
| Yaw | 偏航角：左右摇头，-30°~30° |
| Roll | 翻滚角：歪头，-180°~180° |
| 字段 | 说明 |
|---|---|
| Score | 质量分：0~100，越高越好，建议 > 80 用于人脸入库 |
| Sharpness | 清晰分：0~100，越高越清晰 |
| Brightness | 光照分：0~100，越高光照越好 |
| Completeness | 遮挡分：包含眉毛、眼睛、鼻子、脸颊、嘴巴、下巴遮挡情况 |
# 传入本地图片文件（仅检测人脸位置）
python scripts/main.py --image ./face.jpg
# 传入图片 URL
python scripts/main.py --url "https://example.com/face.jpg"
# 开启属性检测 + 质量检测，最多检测 5 张人脸
python scripts/main.py --image ./face.jpg --need-face-attributes 1 --need-quality-detection 1 --max-face-num 5
# 传入 Base64 字符串
python scripts/main.py --image "<base64_string>"