public class DetectFaceAttributesRequest extends AbstractModel
header, skipSign| 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. | 
| 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。
- 支持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。 
- 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。
- 支持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。 
- 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. | 
any, fromJsonString, getBinaryParams, GetHeader, getMultipartRequestParams, getSkipSign, isStream, set, SetHeader, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonStringpublic DetectFaceAttributesRequest()
public DetectFaceAttributesRequest(DetectFaceAttributesRequest source)
public Long getMaxFaceNum()
public void setMaxFaceNum(Long MaxFaceNum)
MaxFaceNum - 最多处理的人脸数目。 
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。 
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。public String getImage()
public void setImage(String Image)
Image - 图片 base64 数据。
- base64 编码后大小不可超过5M。 
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。public String getUrl()
public void setUrl(String Url)
Url - 图片的 Url 。 
- 对应图片 base64 编码后大小不可超过5M。
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。 
- Url、Image必须提供一个,如果都提供,只使用 Url。 
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。 
- 非腾讯云存储的Url速度和稳定性可能受一定影响。 
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。public String getFaceAttributesType()
public void setFaceAttributesType(String FaceAttributesType)
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 不具备参考意义。public Long getNeedRotateDetection()
public void setNeedRotateDetection(Long NeedRotateDetection)
NeedRotateDetection - 是否开启图片旋转识别支持。
- 0为不开启,1为开启。
- 默认为0。
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。public String getFaceModelVersion()
public void setFaceModelVersion(String FaceModelVersion)
FaceModelVersion - 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入Copyright © 2025. All rights reserved.