Skip to content

FaceDetail

Source code in docs_src/capo_rekognition/types/face_detail.py
class FaceDetail(TypedDict, closed=True):
    bounding_box: NotRequired["capo_rekognition.types.bounding_box.BoundingBox"]
    """<p>Bounding box of the face. Default attribute.</p>"""
    age_range: NotRequired["capo_rekognition.types.age_range.AgeRange"]
    """<p>The estimated age range, in years, for the face. Low represents the lowest estimated age and High represents the highest estimated age.</p>"""
    smile: NotRequired["capo_rekognition.types.smile.Smile"]
    """<p>Indicates whether or not the face is smiling, and the confidence level in the determination.</p>"""
    eyeglasses: NotRequired["capo_rekognition.types.eyeglasses.Eyeglasses"]
    """<p>Indicates whether or not the face is wearing eye glasses, and the confidence level in the determination.</p>"""
    sunglasses: NotRequired["capo_rekognition.types.sunglasses.Sunglasses"]
    """<p>Indicates whether or not the face is wearing sunglasses, and the confidence level in the determination.</p>"""
    gender: NotRequired["capo_rekognition.types.gender.Gender"]
    """<p>The predicted gender of a detected face. </p>"""
    beard: NotRequired["capo_rekognition.types.beard.Beard"]
    """<p>Indicates whether or not the face has a beard, and the confidence level in the determination.</p>"""
    mustache: NotRequired["capo_rekognition.types.mustache.Mustache"]
    """<p>Indicates whether or not the face has a mustache, and the confidence level in the determination.</p>"""
    eyes_open: NotRequired["capo_rekognition.types.eye_open.EyeOpen"]
    """<p>Indicates whether or not the eyes on the face are open, and the confidence level in the determination.</p>"""
    mouth_open: NotRequired["capo_rekognition.types.mouth_open.MouthOpen"]
    """<p>Indicates whether or not the mouth on the face is open, and the confidence level in the determination.</p>"""
    emotions: NotRequired["capo_rekognition.types.emotions.Emotions"]
    """<p>The 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.</p>"""
    landmarks: NotRequired["capo_rekognition.types.landmarks.Landmarks"]
    """<p>Indicates the location of landmarks on the face. Default attribute.</p>"""
    pose: NotRequired["capo_rekognition.types.pose.Pose"]
    """<p>Indicates the pose of the face as determined by its pitch, roll, and yaw. Default attribute.</p>"""
    quality: NotRequired["capo_rekognition.types.image_quality.ImageQuality"]
    """<p>Identifies image brightness and sharpness. Default attribute.</p>"""
    confidence: NotRequired["capo_rekognition.types.percent.Percent"]
    """<p>Confidence level that the bounding box contains a face (and not a different object such as a tree). Default attribute.</p>"""
    face_occluded: NotRequired["capo_rekognition.types.face_occluded.FaceOccluded"]
    """<p> <code>FaceOccluded</code> 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. <code>FaceOccluded</code> 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. </p>"""
    eye_direction: NotRequired["capo_rekognition.types.eye_direction.EyeDirection"]
    """<p>Indicates the direction the eyes are gazing in, as defined by pitch and yaw.</p>"""

age_range instance-attribute

age_range: NotRequired[AgeRange]

The estimated age range, in years, for the face. Low represents the lowest estimated age and High represents the highest estimated age.

beard instance-attribute

beard: NotRequired[Beard]

Indicates whether or not the face has a beard, and the confidence level in the determination.

bounding_box instance-attribute

bounding_box: NotRequired[BoundingBox]

Bounding box of the face. Default attribute.

confidence instance-attribute

confidence: NotRequired[Percent]

Confidence level that the bounding box contains a face (and not a different object such as a tree). Default attribute.

emotions instance-attribute

emotions: NotRequired[Emotions]

The 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.

eye_direction instance-attribute

eye_direction: NotRequired[EyeDirection]

Indicates the direction the eyes are gazing in, as defined by pitch and yaw.

eyeglasses instance-attribute

eyeglasses: NotRequired[Eyeglasses]

Indicates whether or not the face is wearing eye glasses, and the confidence level in the determination.

eyes_open instance-attribute

eyes_open: NotRequired[EyeOpen]

Indicates whether or not the eyes on the face are open, and the confidence level in the determination.

face_occluded instance-attribute

face_occluded: NotRequired[FaceOccluded]

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.

gender instance-attribute

gender: NotRequired[Gender]

The predicted gender of a detected face.

landmarks instance-attribute

landmarks: NotRequired[Landmarks]

Indicates the location of landmarks on the face. Default attribute.

mouth_open instance-attribute

mouth_open: NotRequired[MouthOpen]

Indicates whether or not the mouth on the face is open, and the confidence level in the determination.

mustache instance-attribute

mustache: NotRequired[Mustache]

Indicates whether or not the face has a mustache, and the confidence level in the determination.

pose instance-attribute

pose: NotRequired[Pose]

Indicates the pose of the face as determined by its pitch, roll, and yaw. Default attribute.

quality instance-attribute

quality: NotRequired[ImageQuality]

Identifies image brightness and sharpness. Default attribute.

smile instance-attribute

smile: NotRequired[Smile]

Indicates whether or not the face is smiling, and the confidence level in the determination.

sunglasses instance-attribute

sunglasses: NotRequired[Sunglasses]

Indicates whether or not the face is wearing sunglasses, and the confidence level in the determination.