Class: Aws::Rekognition::Types::DetectFacesRequest

Inherits:

Struct

Object
Struct
Aws::Rekognition::Types::DetectFacesRequest

show all

Defined in:: gems/aws-sdk-rekognition/lib/aws-sdk-rekognition/types.rb

Constant Summary collapse

SENSITIVE =

[]

Instance Attribute Summary collapse

#attributes ⇒ Array<String>
An array of facial attributes you want to be returned.
#image ⇒ Types::Image
The input image as base64-encoded bytes or an S3 object.

Instance Attribute Details

#attributes ⇒ `Array<String>`

An array of facial attributes you want to be returned. A DEFAULT subset of facial attributes - BoundingBox, Confidence, Pose, Quality, and Landmarks - will always be returned. You can request for specific facial attributes (in addition to the default list) - by using ["DEFAULT", "FACE_OCCLUDED"] or just ["FACE_OCCLUDED"]. You can request for all facial attributes by using ["ALL"]. Requesting more attributes may increase response time.

If you provide both, ["ALL", "DEFAULT"], the service uses a logical "AND" operator to determine which attributes to return (in this case, all attributes).

Note that while the FaceOccluded and EyeDirection attributes are supported when using DetectFaces, they aren't supported when analyzing videos with StartFaceDetection and GetFaceDetection.

Returns:

(Array<String>)

# File 'gems/aws-sdk-rekognition/lib/aws-sdk-rekognition/types.rb', line 2142

class DetectFacesRequest < Struct.new(
  :image,
  :attributes)
  SENSITIVE = []
  include Aws::Structure
end

#image ⇒ `Types::Image`

The input image as base64-encoded bytes or an S3 object. If you use the AWS CLI to call Amazon Rekognition operations, passing base64-encoded image bytes is not supported.

If you are using an AWS SDK to call Amazon Rekognition, you might not need to base64-encode image bytes passed using the Bytes field. For more information, see Images in the Amazon Rekognition developer guide.