com.tencentcloudapi.iai.v20200303.models

Class DetectFaceAttributesRequest

java.lang.Object

com.tencentcloudapi.common.AbstractModel

com.tencentcloudapi.iai.v20200303.models.DetectFaceAttributesRequest

public class DetectFaceAttributesRequest
extends AbstractModel

Field Summary

Fields inherited from class com.tencentcloudapi.common.AbstractModel

header, skipSign

Constructor Summary

Constructors

Constructor and Description
DetectFaceAttributesRequest()
DetectFaceAttributesRequest(DetectFaceAttributesRequest source) NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy, and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy.

Method Summary

Modifier and Type	Method and Description
String	getFaceAttributesType() Get 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。
String	getFaceModelVersion() Get 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
String	getImage() Get 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
Long	getMaxFaceNum() Get 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
Long	getNeedRotateDetection() Get 是否开启图片旋转识别支持。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
String	getUrl() Get 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
void	setFaceAttributesType(String FaceAttributesType) Set 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。
void	setFaceModelVersion(String FaceModelVersion) Set 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
void	setImage(String Image) Set 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
void	setMaxFaceNum(Long MaxFaceNum) Set 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。
void	setNeedRotateDetection(Long NeedRotateDetection) Set 是否开启图片旋转识别支持。 - 0为不开启，1为开启。 - 默认为0。 - 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。 - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
void	setUrl(String Url) Set 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
void	toMap(HashMap<String,String> map, String prefix) Internal implementation, normal users should not use it.

Methods inherited from class com.tencentcloudapi.common.AbstractModel

any, fromJsonString, getBinaryParams, GetHeader, getMultipartRequestParams, getSkipSign, isStream, set, SetHeader, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DetectFaceAttributesRequest

public DetectFaceAttributesRequest()

DetectFaceAttributesRequest

public DetectFaceAttributesRequest(DetectFaceAttributesRequest source)

NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy, and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy.

Method Detail

getMaxFaceNum

public Long getMaxFaceNum()

Get 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

Returns:

MaxFaceNum 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

setMaxFaceNum

public void setMaxFaceNum(Long MaxFaceNum)

Set 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

Parameters:

MaxFaceNum - 最多处理的人脸数目。 - 默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。 - 此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。

getImage

public String getImage()

Get 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

Returns:

Image 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

setImage

public void setImage(String Image)

Set 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

Parameters:

Image - 图片 base64 数据。 - base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 - 所有格式的图片短边像素不小于64。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

getUrl

public String getUrl()

Get 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

Returns:

Url 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

setUrl

public void setUrl(String Url)

Set 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

Parameters:

Url - 图片的 Url 。 - 对应图片 base64 编码后大小不可超过5M。 - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。 - Url、Image必须提供一个，如果都提供，只使用 Url。 - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 - 非腾讯云存储的Url速度和稳定性可能受一定影响。 - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

getFaceAttributesType

public String getFaceAttributesType()

Get 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

Returns:

FaceAttributesType 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

setFaceAttributesType

public void setFaceAttributesType(String FaceAttributesType)

Set 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

Parameters:

FaceAttributesType - 是否返回年龄、性别、情绪等属性。 - 合法值为（大小写不敏感）：None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。 - None为不需要返回。 - 默认为 None。即FaceAttributesType属性为空时，各属性返回值为0。 - 需要将属性组成一个用逗号分隔的字符串，属性之间的顺序没有要求。 - 关于各属性的详细描述，参见下文出参。 - 最多返回面积最大的 5 张人脸属性信息，超过 5 张人脸（第 6 张及以后的人脸）的 AttributesInfo 不具备参考意义。

getNeedRotateDetection

public Long getNeedRotateDetection()

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

Returns:

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

setNeedRotateDetection

public void setNeedRotateDetection(Long NeedRotateDetection)

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

Parameters:

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

getFaceModelVersion

public String getFaceModelVersion()

Get 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入

Returns:

FaceModelVersion 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入

setFaceModelVersion

public void setFaceModelVersion(String FaceModelVersion)

Set 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入

Parameters:

FaceModelVersion - 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入

toMap

public void toMap(HashMap<String,String> map,
                  String prefix)

Internal implementation, normal users should not use it.

Specified by:

toMap in class AbstractModel