// 腾讯云稠密人脸关键点(AnalyzeDenseLandmarks)接口调用技能。当用户需要对人脸图片进行稠密关键点定位时，应使用此技能。可返回人脸框坐标，以及人脸各部位（眼睛、眉毛、嘴巴、鼻子、瞳孔、中轴线、下巴、眼袋、额头）的稠密轮廓关键点坐标。支持图片Base64和图片URL两种输入方式。
腾讯云人脸比对(CompareFace)接口调用技能。当用户需要对两张人脸图片进行相似度比对时，应使用此技能。基于腾讯云人脸识别服务，对两张图片中的人脸进行相似度比较，返回人脸相似度分数。支持图片Base64和图片URL两种输入方式，可用于判断两张人脸是否为同一人。
腾讯云人脸检测(DetectFace)接口调用技能。当用户需要对图片进行人脸检测时，应使用此技能。可检测图片中的人脸位置（坐标、宽高），并可选返回人脸属性（性别、年龄、表情、魅力、眼镜、口罩、头发、姿态）和人脸质量信息（质量分、模糊分、光照分、遮挡分）。支持图片Base64和图片URL两种输入方式，支持同时检测多张人脸。
腾讯云人脸静态活体检测高精度版(DetectLiveFaceAccurate)接口调用技能。当用户需要对人脸图片进行防翻拍活体检测时，应使用此技能。相比普通静态活体检测，高精度版增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力，适用于移动端、PC端各类型场景的图片活体检验。支持图片Base64和图片URL两种输入方式。
腾讯云AI人脸防护盾(DetectAIFakeFaces)接口调用技能。当用户需要对人脸图片或视频进行防攻击检测时,应使用此技能。可针对性有效识别高仿真的AIGC换脸、高清翻拍、批量黑产攻击、水印等攻击痕迹,增强对图片和视频的防伪安全能力。支持图片Base64和视频Base64两种输入方式。
| name | tencentcloud-faceid-analyzedenselandmarks |
| description | 腾讯云稠密人脸关键点(AnalyzeDenseLandmarks)接口调用技能。当用户需要对人脸图片进行稠密关键点定位时，应使用此技能。可返回人脸框坐标，以及人脸各部位（眼睛、眉毛、嘴巴、鼻子、瞳孔、中轴线、下巴、眼袋、额头）的稠密轮廓关键点坐标。支持图片Base64和图片URL两种输入方式。 |
调用腾讯云人脸识别（IAI）稠密人脸关键点接口，对请求图片进行五官定位，计算构成人脸轮廓的关键点，包括眉毛、眼睛、鼻子、嘴巴、下巴、脸型轮廓、中轴线等。
核心能力：
官方文档：https://cloud.tencent.com/document/product/867/47397
请确保您委托本服务处理人脸等个人信息已获得个人信息主体合法、有效的同意或具备其他的合法性基础，本服务的相关具体事项以本服务官网所载服务协议约定为准。
当用户提出以下需求时触发此技能：
tencentcloud-sdk-python（通过 pip install tencentcloud-sdk-python 安装）TENCENTCLOUD_SECRET_ID：腾讯云API密钥IDTENCENTCLOUD_SECRET_KEY：腾讯云API密钥Key运行 scripts/main.py 脚本完成稠密人脸关键点检测。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --image | str | 否 | 本地图片文件路径（自动转 Base64）或 Base64 字符串，与 --url 二选一 |
| --url | str | 否 | 图片 URL，与 --image 二选一（都提供时优先使用 URL） |
| --mode | int | 否 | 检测模式：0(检测所有人脸) / 1(仅检测面积最大的人脸)，默认 0 |
| --need-rotate-detection | int | 否 | 是否开启图片旋转识别：0(不开启) / 1(开启)，默认 0 |
| --region | str | 否 | 腾讯云地域，默认 ap-guangzhou |
检测成功后返回 JSON 格式结果：
{
"ImageWidth": 480,
"ImageHeight": 640,
"FaceModelVersion": "3.0",
"FaceCount": 1,
"DenseFaceShapeSet": [
{
"FaceRect": {"X": 100, "Y": 80, "Width": 200, "Height": 250},
"LeftEye": [{"X": 150, "Y": 180}, ...],
"RightEye": [...],
"LeftEyeBrow": [...],
"RightEyeBrow": [...],
"MouthOutside": [...],
"MouthInside": [...],
"Nose": [...],
"LeftPupil": [...],
"RightPupil": [...],
"CentralAxis": [...],
"Chin": [...],
"LeftEyeBags": [...],
"RightEyeBags": [...],
"Forehead": [...]
}
],
"RequestId": "xxx"
}
| 部位字段 | 说明 |
|---|---|
| LeftEye / RightEye | 左/右眼睛轮廓点 |
| LeftEyeBrow / RightEyeBrow | 左/右眉毛轮廓点 |
| MouthOutside | 外嘴巴轮廓点（从左侧开始逆时针） |
| MouthInside | 内嘴巴轮廓点（从左侧开始逆时针） |
| Nose | 鼻子轮廓点 |
| LeftPupil / RightPupil | 左/右瞳孔轮廓点 |
| CentralAxis | 中轴线轮廓点 |
| Chin | 下巴轮廓点 |
| LeftEyeBags / RightEyeBags | 左/右眼袋轮廓点 |
| Forehead | 额头轮廓点 |
# 传入本地图片文件（自动转 Base64）
python scripts/main.py --image ./face.jpg
# 传入图片 URL
python scripts/main.py --url "https://example.com/face.jpg"
# 只检测面积最大的人脸
python scripts/main.py --image ./face.jpg --mode 1
# 开启旋转识别
python scripts/main.py --image ./face.jpg --need-rotate-detection 1