数据万象人脸检测-SDK 文档-文档中心-腾讯云

简介
本文档提供关于人脸检测的相关 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
﻿

参数名称	参数描述	类型	是否必填
Bucket	存储桶名称	String	是
ObjectKey	设置对象名称	String	是
MaxFaceNum	最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。	Integer	否

人脸检测

本页目录：

简介

人脸检测

功能说明

示例代码

参数说明

返回结果说明

response内容

响应体data