Paws::Rekognition::DetectFaces - Arguments for method DetectFaces on Paws::Rekognition


This class represents the parameters used for calling the method DetectFaces on the Amazon Rekognition service. Use the attributes of this class as arguments to method DetectFaces.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to DetectFaces.


    my $rekognition = Paws->service('Rekognition');
    # To detect faces in an image
    # This operation detects faces in an image stored in an AWS S3 bucket.
    my $DetectFacesResponse = $rekognition->DetectFaces(
      'Image' => {
        'S3Object' => {
          'Bucket' => 'mybucket',
          'Name'   => 'myphoto'

    # Results:
    my $FaceDetails           = $DetectFacesResponse->FaceDetails;
    my $OrientationCorrection = $DetectFacesResponse->OrientationCorrection;

    # Returns a L<Paws::Rekognition::DetectFacesResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see


Attributes => ArrayRef[Str|Undef]

An array of facial attributes you want to be returned. This can be the default list of attributes or all attributes. If you don't specify a value for Attributes or if you specify ["DEFAULT"], the API returns the following subset of facial attributes: BoundingBox, Confidence, Pose, Quality, and Landmarks. If you provide ["ALL"], all facial attributes are returned, but the operation takes longer to complete.

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

REQUIRED Image => Paws::Rekognition::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.


This class forms part of Paws, documenting arguments for method DetectFaces in Paws::Rekognition


The source code is located here:

Please report bugs to: