Class: TencentCloud::Iai::V20180301::SearchPersonsRequest

Inherits:

Common::AbstractModel

Object
Common::AbstractModel
TencentCloud::Iai::V20180301::SearchPersonsRequest

show all

Defined in:: lib/v20180301/models.rb

Overview

SearchPersons请求参数结构体

Instance Attribute Summary collapse

#FaceMatchThreshold ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#GroupIds ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#Image ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#MaxFaceNum ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#MaxPersonNum ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#MinFaceSize ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#NeedPersonInfo ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#NeedRotateDetection ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#QualityControl ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.
#Url ⇒ Object

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。.

Instance Method Summary collapse

#deserialize(params) ⇒ Object
#initialize(groupids = nil, image = nil, url = nil, maxfacenum = nil, minfacesize = nil, maxpersonnum = nil, qualitycontrol = nil, facematchthreshold = nil, needpersoninfo = nil, needrotatedetection = nil) ⇒ SearchPersonsRequest constructor

A new instance of SearchPersonsRequest.

Constructor Details

#initialize(groupids = nil, image = nil, url = nil, maxfacenum = nil, minfacesize = nil, maxpersonnum = nil, qualitycontrol = nil, facematchthreshold = nil, needpersoninfo = nil, needrotatedetection = nil) ⇒ `SearchPersonsRequest`

Returns a new instance of SearchPersonsRequest.

# File 'lib/v20180301/models.rb', line 3086

def initialize(groupids=nil, image=nil, url=nil, maxfacenum=nil, minfacesize=nil, maxpersonnum=nil, qualitycontrol=nil, facematchthreshold=nil, needpersoninfo=nil, needrotatedetection=nil)
  @GroupIds = groupids
  @Image = image
  @Url = url
  @MaxFaceNum = maxfacenum
  @MinFaceSize = minfacesize
  @MaxPersonNum = maxpersonnum
  @QualityControl = qualitycontrol
  @FaceMatchThreshold = facematchthreshold
  @NeedPersonInfo = needpersoninfo
  @NeedRotateDetection = needrotatedetection
end

Instance Attribute Details

#FaceMatchThreshold ⇒ `Object`

若图片中包含多张人脸，只选取其中人脸面积最大的人脸。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。值越大，需要处理的时间越长。建议不要超过10。0: 不进行控制；1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；默认 0。若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def FaceMatchThreshold
  @FaceMatchThreshold
end

#GroupIds ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def GroupIds
  @GroupIds
end

#Image ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def Image
  @Image
end

#MaxFaceNum ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def MaxFaceNum
  @MaxFaceNum
end

#MaxPersonNum ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def MaxPersonNum
  @MaxPersonNum
end

#MinFaceSize ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def MinFaceSize
  @MinFaceSize
end

#NeedPersonInfo ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def NeedPersonInfo
  @NeedPersonInfo
end

#NeedRotateDetection ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def NeedRotateDetection
  @NeedRotateDetection
end

#QualityControl ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def QualityControl
  @QualityControl
end

#Url ⇒ `Object`

Parameters:

GroupIds: —

希望搜索的人员库列表，上限100个。
Image: —

图片 base64 数据，base64 编码后大小不可超过5M。
Url: —

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

最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。
MinFaceSize: —

人脸长和宽的最小尺寸，单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
MaxPersonNum: —

单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。
QualityControl: —

图片质量控制。
FaceMatchThreshold: —

出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
NeedPersonInfo: —

是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0
NeedRotateDetection: —

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



3084
3085
3086

# File 'lib/v20180301/models.rb', line 3084

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ `Object`

# File 'lib/v20180301/models.rb', line 3099

def deserialize(params)
  @GroupIds = params['GroupIds']
  @Image = params['Image']
  @Url = params['Url']
  @MaxFaceNum = params['MaxFaceNum']
  @MinFaceSize = params['MinFaceSize']
  @MaxPersonNum = params['MaxPersonNum']
  @QualityControl = params['QualityControl']
  @FaceMatchThreshold = params['FaceMatchThreshold']
  @NeedPersonInfo = params['NeedPersonInfo']
  @NeedRotateDetection = params['NeedRotateDetection']
end

Class: TencentCloud::Iai::V20180301::SearchPersonsRequest

Overview

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(groupids = nil, image = nil, url = nil, maxfacenum = nil, minfacesize = nil, maxpersonnum = nil, qualitycontrol = nil, facematchthreshold = nil, needpersoninfo = nil, needrotatedetection = nil) ⇒ SearchPersonsRequest

Instance Attribute Details

#FaceMatchThreshold ⇒ Object

#GroupIds ⇒ Object

#Image ⇒ Object

#MaxFaceNum ⇒ Object

#MaxPersonNum ⇒ Object

#MinFaceSize ⇒ Object

#NeedPersonInfo ⇒ Object

#NeedRotateDetection ⇒ Object

#QualityControl ⇒ Object

#Url ⇒ Object

Instance Method Details

#deserialize(params) ⇒ Object

#initialize(groupids = nil, image = nil, url = nil, maxfacenum = nil, minfacesize = nil, maxpersonnum = nil, qualitycontrol = nil, facematchthreshold = nil, needpersoninfo = nil, needrotatedetection = nil) ⇒ `SearchPersonsRequest`

#FaceMatchThreshold ⇒ `Object`

#GroupIds ⇒ `Object`

#Image ⇒ `Object`

#MaxFaceNum ⇒ `Object`

#MaxPersonNum ⇒ `Object`

#MinFaceSize ⇒ `Object`

#NeedPersonInfo ⇒ `Object`

#NeedRotateDetection ⇒ `Object`

#QualityControl ⇒ `Object`

#Url ⇒ `Object`

#deserialize(params) ⇒ `Object`