Values.RecognizeCelebritiesResponseSourceReturns an array of celebrities recognized in the input image. For more information, see Recognizing celebrities in the Amazon Rekognition Developer Guide. RecognizeCelebrities returns the 64 largest faces in the image. It lists the recognized celebrities in the CelebrityFaces array and any unrecognized faces in the UnrecognizedFaces array. RecognizeCelebrities doesn't return celebrities whose faces aren't among the largest 64 faces in the image. For each celebrity recognized, RecognizeCelebrities returns a Celebrity object. The Celebrity object contains the celebrity name, ID, URL links to additional information, match confidence, and a ComparedFace object that you can use to locate the celebrity's face on the image. Amazon Rekognition doesn't retain information about which images a celebrity has been recognized in. Your application must store this information and use the Celebrity ID property as a unique identifier for the celebrity. If you don't store the celebrity name or additional information URLs returned by RecognizeCelebrities, you will need the ID to identify the celebrity in a call to the GetCelebrityInfo operation. You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file. For an example, see Recognizing celebrities in an image in the Amazon Rekognition Developer Guide. This operation requires permissions to perform the rekognition:RecognizeCelebrities operation.
type nonrec t = {celebrityFaces : CelebrityList.t option;Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls.
*)unrecognizedFaces : ComparedFaceList.t option;Details about each unrecognized face in the image.
*)orientationCorrection : OrientationCorrection.t option;Support for estimating image orientation using the the OrientationCorrection field has ceased as of August 2021. Any returned values for this field included in an API response will always be NULL. The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected. If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null. The CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.
*)}type nonrec error = [ | `AccessDeniedException of AccessDeniedException.t| `ImageTooLargeException of ImageTooLargeException.t| `InternalServerError of InternalServerError.t| `InvalidImageFormatException of InvalidImageFormatException.t| `InvalidParameterException of InvalidParameterException.t| `InvalidS3ObjectException of InvalidS3ObjectException.t| `ProvisionedThroughputExceededException of
ProvisionedThroughputExceededException.t| `ThrottlingException of ThrottlingException.t| `Unknown_operation_error of string * string option ]val error_of_json :
string ->
Yojson.Safe.t ->
[> `AccessDeniedException of unit
| `ImageTooLargeException of unit
| `InternalServerError of unit
| `InvalidImageFormatException of unit
| `InvalidParameterException of unit
| `InvalidS3ObjectException of unit
| `ProvisionedThroughputExceededException of unit
| `ThrottlingException of unit
| `Unknown_operation_error of string * string option ]val error_of_xml :
string ->
Awso.Xml.t ->
[> `AccessDeniedException of unit
| `ImageTooLargeException of unit
| `InternalServerError of unit
| `InvalidImageFormatException of unit
| `InvalidParameterException of unit
| `InvalidS3ObjectException of unit
| `ProvisionedThroughputExceededException of unit
| `ThrottlingException of unit
| `Unknown_operation_error of string * string option ]val to_value :
t ->
[> `Structure of
(string
* [> `Enum of string
| `List of
[> `Structure of
(string
* [> `Float of Percent.t
| `List of
[> `String of Url.t
| `Structure of
(string * [> `Enum of string | `Float of Float_.t ])
list ]
list
| `String of String_.t
| `Structure of
(string
* [> `Boolean of Boolean.t
| `Enum of string
| `Float of Percent.t
| `List of
[> `Structure of
(string
* [> `Enum of string | `Float of Float_.t ])
list ]
list
| `Structure of
(string
* [> `Boolean of Boolean.t | `Float of Float_.t ])
list ])
list ])
list ]
list ])
list ]