Class: TencentCloud::Iai::V20200303::SearchFacesReturnsByGroupRequest

Inherits:

Common::AbstractModel

• Object
• Common::AbstractModel
• TencentCloud::Iai::V20200303::SearchFacesReturnsByGroupRequest

Defined in:

lib/v20200303/models.rb

Overview

SearchFacesReturnsByGroup请求参数结构体

Instance Attribute Summary

• #FaceMatchThreshold ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #GroupIds ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #Image ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #MaxFaceNum ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #MaxPersonNumPerGroup ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #MinFaceSize ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #NeedPersonInfo ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #NeedRotateDetection ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #QualityControl ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #Url ⇒ Object

  • 数组元素取值为创建人员库接口中的GroupId。 - 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。 - 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 图片。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 - MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 - 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。 - 默认为34。 - 低于34将影响搜索精度。 - 建议设置为80。 - 默认值为5，最大值为10。 - 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。 - 取值范围：0 为关闭，1 为开启。 - 默认为 0。 - 其他非0非1值默认为0 - 取值范围： 0: 不进行控制。 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况。 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况。 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题。 - 默认 0。 - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。 - 默认为0。 - 取值范围：[0.0,100.0) 。 - 取值范围：0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

Instance Method Summary

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

  A new instance of SearchFacesReturnsByGroupRequest.

Constructor Details

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

Returns a new instance of SearchFacesReturnsByGroupRequest.

# File 'lib/v20200303/models.rb', line 3354

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

Instance Attribute Details

#FaceMatchThreshold ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def FaceMatchThreshold
  @FaceMatchThreshold
end

#GroupIds ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def GroupIds
  @GroupIds
end

#Image ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def Image
  @Image
end

#MaxFaceNum ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def MaxFaceNum
  @MaxFaceNum
end

#MaxPersonNumPerGroup ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def MaxPersonNumPerGroup
  @MaxPersonNumPerGroup
end

#MinFaceSize ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def MinFaceSize
  @MinFaceSize
end

#NeedPersonInfo ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def NeedPersonInfo
  @NeedPersonInfo
end

#NeedRotateDetection ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def NeedRotateDetection
  @NeedRotateDetection
end

#QualityControl ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def QualityControl
  @QualityControl
end

#Url ⇒ Object

• 数组元素取值为创建人员库接口中的GroupId。

• 不可同时搜索不同算法模型版本（FaceModelVersion）的人员库。

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

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

• MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。

• 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

• 默认为34。

• 低于34将影响搜索精度。

• 建议设置为80。

• 默认值为5，最大值为10。

• 例，设MaxFaceNum为3，MaxPersonNumPerGroup为5，GroupIds长度为3，则最多可能返回3*5*3=45个人员。

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

• 默认为 0。

• 其他非0非1值默认为0

• 取值范围：

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

• 默认 0。

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

• 默认为0。

• 取值范围：[0.0,100.0) 。

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

• 默认为0。

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

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

Parameters:

• GroupIds: —

  希望搜索的人员库列表，上限60个。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• MaxFaceNum: —

  最多识别的人脸数目。

• MinFaceSize: —

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

• MaxPersonNumPerGroup: —

  被检测到的人脸，对应最多返回的最相似人员数目。

• NeedPersonInfo: —

  是否返回人员具体信息。

• QualityControl: —

  图片质量控制。

• FaceMatchThreshold: —

  出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。

• NeedRotateDetection: —

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

# File 'lib/v20200303/models.rb', line 3352

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ Object

# File 'lib/v20200303/models.rb', line 3367

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