Class: TencentCloud::Iai::V20180301::DetectFaceRequest

Inherits:
Common::AbstractModel
  • Object
show all
Defined in:
lib/v20180301/models.rb

Overview

DetectFace请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(maxfacenum = nil, minfacesize = nil, image = nil, url = nil, needfaceattributes = nil, needqualitydetection = nil, facemodelversion = nil, needrotatedetection = nil) ⇒ DetectFaceRequest

Returns a new instance of DetectFaceRequest.



1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
# File 'lib/v20180301/models.rb', line 1153

def initialize(maxfacenum=nil, minfacesize=nil, image=nil, url=nil, needfaceattributes=nil, needqualitydetection=nil, facemodelversion=nil, needrotatedetection=nil)
  @MaxFaceNum = maxfacenum
  @MinFaceSize = minfacesize
  @Image = image
  @Url = url
  @NeedFaceAttributes = needfaceattributes
  @NeedQualityDetection = needqualitydetection
  @FaceModelVersion = facemodelversion
  @NeedRotateDetection = needrotatedetection
end

Instance Attribute Details

#FaceModelVersionObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def FaceModelVersion
  @FaceModelVersion
end

#ImageObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def Image
  @Image
end

#MaxFaceNumObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def MaxFaceNum
  @MaxFaceNum
end

#MinFaceSizeObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def MinFaceSize
  @MinFaceSize
end

#NeedFaceAttributesObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def NeedFaceAttributes
  @NeedFaceAttributes
end

#NeedQualityDetectionObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def NeedQualityDetection
  @NeedQualityDetection
end

#NeedRotateDetectionObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def NeedRotateDetection
  @NeedRotateDetection
end

#UrlObject

此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。默认为34。建议不低于34。低于MinFaceSize值的人脸不会被检测。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。Url、Image必须提供一个,如果都提供,只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。非 1 值均视为不进行质量检测。最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。建议:人脸入库操作建议开启此功能。2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。

Parameters:

  • MaxFaceNum:

    最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。

  • MinFaceSize:

    人脸长和宽的最小尺寸,单位为像素。

  • Image:

    图片 base64 数据,base64 编码后大小不可超过5M。

  • Url:

    图片的 Url 。对应图片 base64 编码后大小不可超过5M。

  • NeedFaceAttributes:

    是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。

  • NeedQualityDetection:

    是否开启质量检测。0 为关闭,1 为开启。默认为 0。

  • FaceModelVersion:

    人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。

  • NeedRotateDetection:

    是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。



1151
1152
1153
# File 'lib/v20180301/models.rb', line 1151

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ Object



1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
# File 'lib/v20180301/models.rb', line 1164

def deserialize(params)
  @MaxFaceNum = params['MaxFaceNum']
  @MinFaceSize = params['MinFaceSize']
  @Image = params['Image']
  @Url = params['Url']
  @NeedFaceAttributes = params['NeedFaceAttributes']
  @NeedQualityDetection = params['NeedQualityDetection']
  @FaceModelVersion = params['FaceModelVersion']
  @NeedRotateDetection = params['NeedRotateDetection']
end