Class: TencentCloud::Iai::V20200303::DetectFaceRequest

Inherits:

Common::AbstractModel

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

Defined in:

lib/v20200303/models.rb

Overview

DetectFace请求参数结构体

Instance Attribute Summary

• #FaceModelVersion ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #Image ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #MaxFaceNum ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #MinFaceSize ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #NeedFaceAttributes ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #NeedQualityDetection ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #NeedRotateDetection ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

• #Url ⇒ Object

  • 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 - 只支持设置34和20，建议使用34。 - 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 图片。 - 0 为不需要返回，1 为需要返回。 - 默认为 0。 - 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 FaceAttributesInfo 不具备参考意义。 - 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。 - 0 为关闭，1 为开启。 - 默认为 0。 - 非 1 值均视为不进行质量检测。 - 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。 - 建议：人脸入库操作建议开启此功能。 - 目前入参支持 “2.0”和“3.0“ 两个输入。 - 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。 - 2020年11月26日后开通服务的账号仅支持输入“3.0”。 - 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。.

Instance Method Summary

• #deserialize(params) ⇒ Object
• #initialize(maxfacenum = nil, minfacesize = nil, image = nil, url = nil, needfaceattributes = nil, needqualitydetection = nil, facemodelversion = nil, needrotatedetection = nil) ⇒ DetectFaceRequest constructor

  A new instance of DetectFaceRequest.

Constructor Details

#initialize(maxfacenum = nil, minfacesize = nil, image = nil, url = nil, needfaceattributes = nil, needqualitydetection = nil, facemodelversion = nil, needrotatedetection = nil) ⇒ DetectFaceRequest

Returns a new instance of DetectFaceRequest.

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

def initialize(maxfacenum=nil, minfacesize=nil, image=nil, url=nil, needfaceattributes=nil, needqualitydetection=nil, facemodelversion=nil, needrotatedetection=nil)
  @MaxFaceNum = maxfacenum
  @MinFaceSize = minfacesize
  @Image = image
  @Url = url
  @NeedFaceAttributes = needfaceattributes
  @NeedQualityDetection = needqualitydetection
  @FaceModelVersion = facemodelversion
  @NeedRotateDetection = needrotatedetection
end

Instance Attribute Details

#FaceModelVersion ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def FaceModelVersion
  @FaceModelVersion
end

#Image ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def Image
  @Image
end

#MaxFaceNum ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def MaxFaceNum
  @MaxFaceNum
end

#MinFaceSize ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def MinFaceSize
  @MinFaceSize
end

#NeedFaceAttributes ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def NeedFaceAttributes
  @NeedFaceAttributes
end

#NeedQualityDetection ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def NeedQualityDetection
  @NeedQualityDetection
end

#NeedRotateDetection ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def NeedRotateDetection
  @NeedRotateDetection
end

#Url ⇒ Object

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

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

• 只支持设置34和20，建议使用34。

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

• 0 为不需要返回，1 为需要返回。

• 默认为 0。

• 非 1 值均视为不需要返回，此时 FaceAttributesInfo 不具备参考意义。

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

• 提取人脸属性信息较为耗时，如不需要人脸属性信息，建议关闭此项功能，加快人脸检测速度。

• 0 为关闭，1 为开启。

• 默认为 0。

• 非 1 值均视为不进行质量检测。

• 最多返回面积最大的 30 张人脸质量分信息，超过 30 张人脸（第 31 张及以后的人脸）的 FaceQualityInfo不具备参考意义。

• 建议：人脸入库操作建议开启此功能。

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

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

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

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

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

• 默认为0。

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

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

Parameters:

• MaxFaceNum: —

  最多处理的人脸数目。

• MinFaceSize: —

  人脸长和宽的最小尺寸，单位为像素，低于MinFaceSize值的人脸不会被检测。

• Image: —

  图片 base64 数据。

• Url: —

  图片的 Url 。

• NeedFaceAttributes: —

  是否需要返回人脸属性信息（FaceAttributesInfo）。

• NeedQualityDetection: —

  是否开启质量检测。

• FaceModelVersion: —

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

• NeedRotateDetection: —

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

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

def Url
  @Url
end

Instance Method Details

#deserialize(params) ⇒ Object

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

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