Class: TencentCloud::Iai::V20200303::AnalyzeFaceRequest

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

Overview

AnalyzeFace请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(mode = nil, image = nil, url = nil, facemodelversion = nil, needrotatedetection = nil) ⇒ AnalyzeFaceRequest

Returns a new instance of AnalyzeFaceRequest.



144
145
146
147
148
149
150
 
# File 'lib/v20200303/models.rb', line 144

def initialize(mode=nil, image=nil, url=nil, facemodelversion=nil, needrotatedetection=nil)
  @Mode = mode
  @Image = image
  @Url = url
  @FaceModelVersion = facemodelversion
  @NeedRotateDetection = needrotatedetection
end

Instance Attribute Details

#FaceModelVersion ⇒ Object

  • 取值范围：

0 为检测所有出现的人脸。1 为检测面积最大的人脸。

  • 默认为 0。

  • 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。

  • 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 图片。

  • 目前入参支持 “2.0”和“3.0“ 两个输入。

  • 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。

  • 2020年11月26日后开通服务的账号仅支持输入“3.0”。

  • 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。

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

  • 默认为0。

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

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

Parameters:

  • Mode: —

    检测模式。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。

  • NeedRotateDetection: —

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



142
143
144
 
# File 'lib/v20200303/models.rb', line 142

def FaceModelVersion
  @FaceModelVersion
end

#Image ⇒ Object

  • 取值范围：

0 为检测所有出现的人脸。1 为检测面积最大的人脸。

  • 默认为 0。

  • 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。

  • 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 图片。

  • 目前入参支持 “2.0”和“3.0“ 两个输入。

  • 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。

  • 2020年11月26日后开通服务的账号仅支持输入“3.0”。

  • 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。

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

  • 默认为0。

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

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

Parameters:

  • Mode: —

    检测模式。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。

  • NeedRotateDetection: —

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



142
143
144
 
# File 'lib/v20200303/models.rb', line 142

def Image
  @Image
end

#Mode ⇒ Object

  • 取值范围：

0 为检测所有出现的人脸。1 为检测面积最大的人脸。

  • 默认为 0。

  • 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。

  • 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 图片。

  • 目前入参支持 “2.0”和“3.0“ 两个输入。

  • 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。

  • 2020年11月26日后开通服务的账号仅支持输入“3.0”。

  • 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。

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

  • 默认为0。

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

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

Parameters:

  • Mode: —

    检测模式。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。

  • NeedRotateDetection: —

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



142
143
144
 
# File 'lib/v20200303/models.rb', line 142

def Mode
  @Mode
end

#NeedRotateDetection ⇒ Object

  • 取值范围：

0 为检测所有出现的人脸。1 为检测面积最大的人脸。

  • 默认为 0。

  • 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。

  • 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 图片。

  • 目前入参支持 “2.0”和“3.0“ 两个输入。

  • 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。

  • 2020年11月26日后开通服务的账号仅支持输入“3.0”。

  • 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。

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

  • 默认为0。

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

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

Parameters:

  • Mode: —

    检测模式。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。

  • NeedRotateDetection: —

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



142
143
144
 
# File 'lib/v20200303/models.rb', line 142

def NeedRotateDetection
  @NeedRotateDetection
end

#Url ⇒ Object

  • 取值范围：

0 为检测所有出现的人脸。1 为检测面积最大的人脸。

  • 默认为 0。

  • 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。

  • 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 图片。

  • 目前入参支持 “2.0”和“3.0“ 两个输入。

  • 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。

  • 2020年11月26日后开通服务的账号仅支持输入“3.0”。

  • 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。

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

  • 默认为0。

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

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

Parameters:

  • Mode: —

    检测模式。

  • Image: —

    图片 base64 数据。

  • Url: —

    图片的 Url 。

  • FaceModelVersion: —

    人脸识别服务所用的算法模型版本。

  • NeedRotateDetection: —

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



142
143
144
 
# File 'lib/v20200303/models.rb', line 142

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ Object 



152
153
154
155
156
157
158
 
# File 'lib/v20200303/models.rb', line 152

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