人脸检测

最近更新时间:2024-08-02 10:06:51

我的收藏

简介

本文档提供关于人脸检测的相关 API 概览以及 SDK 示例代码。
API
操作描述
人脸检测

人脸检测

功能说明

人脸检测功能为同步请求方式,您可以通过本接口检测图片中的人脸位置。该接口属于 GET 请求。

示例代码

def cos_ai_detect_face():
# 人脸检测
# https://github.com/tencentyun/cos-python-sdk-v5/blob/master/demo/ai_recognition_demo.py#L111
response, data = client.cos_ai_detect_face(
Bucket=bucket_name,
ObjectKey = "objectKey",
MaxFaceNum = 3
)
print(response)
print(data)
return response, data

参数说明

调用 cos_ai_detect_face 函数,具体请求参数如下:
参数名称
参数描述
类型
是否必填
Bucket
存储桶名称
String
ObjectKey
设置对象名称
String
MaxFaceNum
最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
Integer

返回结果说明

response 为响应头,data 为人脸检测结果,数据类型都为 dict。
response内容
返回公共响应头部,详情请参见 公共响应头部 文档。
响应体data
由于接口默认返回xml内容,解析结果都为string类型,以下描述为字段的真实类型。具体数据内容如下:
参数名称
参数描述
类型
ImageWidth
请求的图片宽度。
Integer
ImageHeight
请求的图片高度。
Integer
FaceModelVersion
人脸识别所用的算法模型版本。
String
RequestId
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
String
FaceInfos
人脸信息列表。包含人脸坐标信息。
Container
Status
是否识别到人脸
String
FaceInfos 节点内容:
参数名称
参数描述
类型
X
人脸框左上角横坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
Integer
Y
人脸框左上角纵坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
Integer
Width
人脸框宽度。
Integer
Height
人脸框高度。
Integer