Detects faces within an image (JPEG or PNG) that is provided as input.
For each face detected, the operation returns face details including a bounding box of the face, a confidence value (that the bounding box contains a face), and a fixed set of attributes such as facial landmarks (for example, coordinates of eye and mouth), gender, presence of beard, sunglasses, etc.
The face-detection algorithm is most effective on frontal faces. For non-frontal or obscured faces, the algorithm may not detect the faces or might detect faces with lower confidence.
This is a stateless API operation. That is, the operation does not persist any data.
For an example, see get-started-exercise-detect-faces.
This operation requires permissions to perform the rekognition:DetectFaces
action.
/// You are not authorized to perform the action.
///
/// The input image size exceeds the allowed limit. For more information, see
limits.
///
/// Amazon Rekognition experienced a service issue. Try your call again.
///
/// The provided image format is not supported.
///
/// Input parameter violated a constraint. Validate your parameter before calling the
/// API again.
///
/// Amazon Rekognition is unable to access the S3 object specified in the request.
///
/// The number of requests exceeded your throughput limit. If you want to increase this
/// limit, contact Amazon Rekognition.
///
/// Amazon Rekognition is temporarily unable to process the request. Try your call again.
///