Class: TencentCloud::Iai::V20200303::CreateFaceRequest

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

Overview

CreateFace请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(personid = nil, images = nil, urls = nil, facematchthreshold = nil, qualitycontrol = nil, needrotatedetection = nil) ⇒ CreateFaceRequest

Returns a new instance of CreateFaceRequest.



568
569
570
571
572
573
574
575
 
# File 'lib/v20200303/models.rb', line 568

def initialize(personid=nil, images=nil, urls=nil, facematchthreshold=nil, qualitycontrol=nil, needrotatedetection=nil)
  @PersonId = personid
  @Images = images
  @Urls = urls
  @FaceMatchThreshold = facematchthreshold
  @QualityControl = qualitycontrol
  @NeedRotateDetection = needrotatedetection
end

Instance Attribute Details

#FaceMatchThreshold ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def FaceMatchThreshold
  @FaceMatchThreshold
end

#Images ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def Images
  @Images
end

#NeedRotateDetection ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def NeedRotateDetection
  @NeedRotateDetection
end

#PersonId ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def PersonId
  @PersonId
end

#QualityControl ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def QualityControl
  @QualityControl
end

#Urls ⇒ Object

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

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

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

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

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

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

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

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

  • 人员人脸总数量不可超过5张。

  • 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。

  • 默认值60分。

  • 取值范围： 。

  • 取值范围：

0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；

  • 默认 0。

  • 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

  • 取值范围：0为不开启，1为开启。

  • 默认为0。

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

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

Parameters:

  • PersonId: —

    人员ID，取值为创建人员接口中的PersonId。

  • Images: —

    图片 base64 数据。

  • Urls: —

    图片的 Url 。

  • FaceMatchThreshold: —

    只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸，才能增加人脸成功。

  • QualityControl: —

    图片质量控制。

  • NeedRotateDetection: —

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



566
567
568
 
# File 'lib/v20200303/models.rb', line 566

def Urls
  @Urls
end

Instance Method Details

#deserialize(params) ⇒ Object 



577
578
579
580
581
582
583
584
 
# File 'lib/v20200303/models.rb', line 577

def deserialize(params)
  @PersonId = params['PersonId']
  @Images = params['Images']
  @Urls = params['Urls']
  @FaceMatchThreshold = params['FaceMatchThreshold']
  @QualityControl = params['QualityControl']
  @NeedRotateDetection = params['NeedRotateDetection']
end