Optional
AgeThe estimated age range, in years, for the face. Low represents the lowest estimated age and High represents the highest estimated age.
Optional
BeardIndicates whether or not the face has a beard, and the confidence level in the determination.
Optional
BoundingBounding box of the face. Default attribute.
Optional
ConfidenceConfidence level that the bounding box contains a face (and not a different object such as a tree). Default attribute.
Optional
EmotionsThe emotions that appear to be expressed on the face, and the confidence level in the determination. The API is only making a determination of the physical appearance of a person's face. It is not a determination of the person’s internal emotional state and should not be used in such a way. For example, a person pretending to have a sad face might not be sad emotionally.
Optional
EyeIndicates the direction the eyes are gazing in, as defined by pitch and yaw.
Optional
EyeglassesIndicates whether or not the face is wearing eye glasses, and the confidence level in the determination.
Optional
EyesIndicates whether or not the eyes on the face are open, and the confidence level in the determination.
Optional
Face
FaceOccluded
should return "true" with a high confidence score if a detected
face’s eyes, nose, and mouth are partially captured or if they are covered by masks, dark
sunglasses, cell phones, hands, or other objects. FaceOccluded
should return
"false" with a high confidence score if common occurrences that do not impact face
verification are detected, such as eye glasses, lightly tinted sunglasses, strands of hair,
and others.
Optional
GenderThe predicted gender of a detected face.
Optional
LandmarksIndicates the location of landmarks on the face. Default attribute.
Optional
MouthIndicates whether or not the mouth on the face is open, and the confidence level in the determination.
Optional
MustacheIndicates whether or not the face has a mustache, and the confidence level in the determination.
Optional
PoseIndicates the pose of the face as determined by its pitch, roll, and yaw. Default attribute.
Optional
QualityIdentifies image brightness and sharpness. Default attribute.
Optional
SmileIndicates whether or not the face is smiling, and the confidence level in the determination.
Optional
SunglassesIndicates whether or not the face is wearing sunglasses, and the confidence level in the determination.
Structure containing attributes of the face that the algorithm detected.
A
FaceDetail
object contains either the default facial attributes or all facial attributes. The default attributes areBoundingBox
,Confidence
,Landmarks
,Pose
, andQuality
.GetFaceDetection is the only Amazon Rekognition Video stored video operation that can return a
FaceDetail
object with all attributes. To specify which attributes to return, use theFaceAttributes
input parameter for StartFaceDetection. The following Amazon Rekognition Video operations return only the default attributes. The corresponding Start operations don't have aFaceAttributes
input parameter:GetCelebrityRecognition
GetPersonTracking
GetFaceSearch
The Amazon Rekognition Image DetectFaces and IndexFaces operations can return all facial attributes. To specify which attributes to return, use the
Attributes
input parameter forDetectFaces
. ForIndexFaces
, use theDetectAttributes
input parameter.