Class: TencentCloud::Iai::V20200303::DetectFaceAttributesRequest

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

Overview

DetectFaceAttributes请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(maxfacenum = nil, image = nil, url = nil, faceattributestype = nil, needrotatedetection = nil, facemodelversion = nil) ⇒ DetectFaceAttributesRequest

Returns a new instance of DetectFaceAttributesRequest.



1198
1199
1200
1201
1202
1203
1204
1205
 
# File 'lib/v20200303/models.rb', line 1198

def initialize(maxfacenum=nil, image=nil, url=nil, faceattributestype=nil, needrotatedetection=nil, facemodelversion=nil)
  @MaxFaceNum = maxfacenum
  @Image = image
  @Url = url
  @FaceAttributesType = faceattributestype
  @NeedRotateDetection = needrotatedetection
  @FaceModelVersion = facemodelversion
end

Instance Attribute Details

#FaceAttributesType ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def FaceAttributesType
  @FaceAttributesType
end

#FaceModelVersion ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def FaceModelVersion
  @FaceModelVersion
end

#Image ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def Image
  @Image
end

#MaxFaceNum ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def MaxFaceNum
  @MaxFaceNum
end

#NeedRotateDetection ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def NeedRotateDetection
  @NeedRotateDetection
end

#Url ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。

  • 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

  • base64 编码后大小不可超过5M。

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。

  • 所有格式的图片短边像素不小于64。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

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

  • jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。

  • Url、Image必须提供一个，如果都提供，只使用 Url。

  • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。

  • 非腾讯云存储的Url速度和稳定性可能受一定影响。

  • 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

  • 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。

  • None为不需要返回。

  • 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。

  • 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。

  • 关于各属性的详细描述，参见下文出参。

  • 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

  • 0为不开启，1为开启。

  • 默认为0。

  • 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。

  • 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。

Parameters:

  • MaxFaceNum: —

    最多处理的人脸数目。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceAttributesType: —

    是否返回年龄、性别、情绪等属性。

  • NeedRotateDetection: —

    是否开启图片旋转识别支持。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入



1196
1197
1198
 
# File 'lib/v20200303/models.rb', line 1196

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ Object 



1207
1208
1209
1210
1211
1212
1213
1214
 
# File 'lib/v20200303/models.rb', line 1207

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