5.0.0 • Published 7 years ago
@datafire/amazonaws_rekognition v5.0.0
@datafire/amazonaws_rekognition
Client library for Amazon Rekognition
Installation and Usage
npm install --save @datafire/amazonaws_rekognition
let amazonaws_rekognition = require('@datafire/amazonaws_rekognition').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_rekognition.CompareFaces({
"SourceImage": {},
"TargetImage": {}
}).then(data => {
console.log(data);
});
Description
This is the Amazon Rekognition API reference.
Actions
CompareFaces
amazonaws_rekognition.CompareFaces({
"SourceImage": {},
"TargetImage": {}
}, context)
Input
Output
- output CompareFacesResponse
CreateCollection
amazonaws_rekognition.CreateCollection({
"CollectionId": ""
}, context)
Input
- input
object
- CollectionId required CollectionId
Output
- output CreateCollectionResponse
CreateStreamProcessor
amazonaws_rekognition.CreateStreamProcessor({
"Input": {},
"Output": {},
"Name": "",
"Settings": {},
"RoleArn": ""
}, context)
Input
- input
object
- Input required StreamProcessorInput
- Name required StreamProcessorName
- Output required StreamProcessorOutput
- RoleArn required RoleArn
- Settings required StreamProcessorSettings
Output
DeleteCollection
amazonaws_rekognition.DeleteCollection({
"CollectionId": ""
}, context)
Input
- input
object
- CollectionId required CollectionId
Output
- output DeleteCollectionResponse
DeleteFaces
amazonaws_rekognition.DeleteFaces({
"CollectionId": "",
"FaceIds": []
}, context)
Input
- input
object
- CollectionId required CollectionId
- FaceIds required FaceIdList
Output
- output DeleteFacesResponse
DeleteStreamProcessor
amazonaws_rekognition.DeleteStreamProcessor({
"Name": ""
}, context)
Input
- input
object
- Name required StreamProcessorName
Output
DescribeStreamProcessor
amazonaws_rekognition.DescribeStreamProcessor({
"Name": ""
}, context)
Input
- input
object
- Name required StreamProcessorName
Output
DetectFaces
amazonaws_rekognition.DetectFaces({
"Image": {}
}, context)
Input
- input
object
- Attributes Attributes
- Image required Image
Output
- output DetectFacesResponse
DetectLabels
amazonaws_rekognition.DetectLabels({
"Image": {}
}, context)
Input
Output
- output DetectLabelsResponse
DetectModerationLabels
amazonaws_rekognition.DetectModerationLabels({
"Image": {}
}, context)
Input
Output
DetectText
amazonaws_rekognition.DetectText({
"Image": {}
}, context)
Input
- input
object
- Image required Image
Output
- output DetectTextResponse
GetCelebrityInfo
amazonaws_rekognition.GetCelebrityInfo({
"Id": ""
}, context)
Input
- input
object
- Id required RekognitionUniqueId
Output
- output GetCelebrityInfoResponse
GetCelebrityRecognition
amazonaws_rekognition.GetCelebrityRecognition({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy CelebrityRecognitionSortBy
- MaxResults
Output
GetContentModeration
amazonaws_rekognition.GetContentModeration({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy ContentModerationSortBy
- MaxResults
Output
- output GetContentModerationResponse
GetFaceDetection
amazonaws_rekognition.GetFaceDetection({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- MaxResults
Output
- output GetFaceDetectionResponse
GetFaceSearch
amazonaws_rekognition.GetFaceSearch({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy FaceSearchSortBy
- MaxResults
Output
- output GetFaceSearchResponse
GetLabelDetection
amazonaws_rekognition.GetLabelDetection({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy LabelDetectionSortBy
- MaxResults
Output
- output GetLabelDetectionResponse
GetPersonTracking
amazonaws_rekognition.GetPersonTracking({
"JobId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy PersonTrackingSortBy
- MaxResults
Output
- output GetPersonTrackingResponse
IndexFaces
amazonaws_rekognition.IndexFaces({
"CollectionId": "",
"Image": {}
}, context)
Input
- input
object
- CollectionId required CollectionId
- DetectionAttributes Attributes
- ExternalImageId ExternalImageId
- Image required Image
Output
- output IndexFacesResponse
ListCollections
amazonaws_rekognition.ListCollections({}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- MaxResults PageSize
- NextToken PaginationToken
- MaxResults
Output
- output ListCollectionsResponse
ListFaces
amazonaws_rekognition.ListFaces({
"CollectionId": ""
}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- CollectionId required CollectionId
- MaxResults PageSize
- NextToken PaginationToken
- MaxResults
Output
- output ListFacesResponse
ListStreamProcessors
amazonaws_rekognition.ListStreamProcessors({}, context)
Input
- input
object
- MaxResults
string
- NextToken
string
- MaxResults MaxResults
- NextToken PaginationToken
- MaxResults
Output
- output ListStreamProcessorsResponse
RecognizeCelebrities
amazonaws_rekognition.RecognizeCelebrities({
"Image": {}
}, context)
Input
- input
object
- Image required Image
Output
- output RecognizeCelebritiesResponse
SearchFaces
amazonaws_rekognition.SearchFaces({
"CollectionId": "",
"FaceId": ""
}, context)
Input
- input
object
- CollectionId required CollectionId
- FaceId required FaceId
- FaceMatchThreshold Percent
- MaxFaces MaxFaces
Output
- output SearchFacesResponse
SearchFacesByImage
amazonaws_rekognition.SearchFacesByImage({
"CollectionId": "",
"Image": {}
}, context)
Input
- input
object
- CollectionId required CollectionId
- FaceMatchThreshold Percent
- Image required Image
- MaxFaces MaxFaces
Output
- output SearchFacesByImageResponse
StartCelebrityRecognition
amazonaws_rekognition.StartCelebrityRecognition({
"Video": {}
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
Output
StartContentModeration
amazonaws_rekognition.StartContentModeration({
"Video": {}
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- MinConfidence Percent
- NotificationChannel NotificationChannel
- Video required Video
Output
StartFaceDetection
amazonaws_rekognition.StartFaceDetection({
"Video": {}
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- FaceAttributes FaceAttributes
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
Output
- output StartFaceDetectionResponse
StartFaceSearch
amazonaws_rekognition.StartFaceSearch({
"Video": {},
"CollectionId": ""
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- CollectionId required CollectionId
- FaceMatchThreshold Percent
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
Output
- output StartFaceSearchResponse
StartLabelDetection
amazonaws_rekognition.StartLabelDetection({
"Video": {}
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- MinConfidence Percent
- NotificationChannel NotificationChannel
- Video required Video
Output
- output StartLabelDetectionResponse
StartPersonTracking
amazonaws_rekognition.StartPersonTracking({
"Video": {}
}, context)
Input
- input
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
Output
- output StartPersonTrackingResponse
StartStreamProcessor
amazonaws_rekognition.StartStreamProcessor({
"Name": ""
}, context)
Input
- input
object
- Name required StreamProcessorName
Output
- output StartStreamProcessorResponse
StopStreamProcessor
amazonaws_rekognition.StopStreamProcessor({
"Name": ""
}, context)
Input
- input
object
- Name required StreamProcessorName
Output
- output StopStreamProcessorResponse
Definitions
AccessDeniedException
- AccessDeniedException
object
: You are not authorized to perform the action.
AgeRange
- AgeRange
object
: Structure containing the estimated age range, in years, for a face. Rekognition estimates an age-range for faces detected in the input image. Estimated age ranges can overlap; a face of a 5 year old may have an estimated range of 4-6 whilst the face of a 6 year old may have an estimated range of 4-8.
Attribute
- Attribute
string
(values: DEFAULT, ALL)
Attributes
- Attributes
array
- items Attribute
Beard
- Beard
object
: Indicates whether or not the face has a beard, and the confidence level in the determination.
Boolean
- Boolean
boolean
BoundingBox
- BoundingBox
object
: Identifies the bounding box around the object, face or text. The left (x-coordinate) and top (y-coordinate) are coordinates representing the top and left sides of the bounding box. Note that the upper-left corner of the image is the origin (0,0). The top and left values returned are ratios of the overall image size. For example, if the input image is 700x200 pixels, and the top-left coordinate of the bounding box is 350x50 pixels, the API returns a left value of 0.5 (350/700) and a top value of 0.25 (50/200). The width and height values represent the dimensions of the bounding box as a ratio of the overall image dimension. For example, if the input image is 700x200 pixels, and the bounding box width is 70 pixels, the width returned is 0.1. The bounding box coordinates can have negative values. For example, if Amazon Rekognition is able to detect a face that is at the image edge and is only partially visible, the service can return coordinates that are outside the image bounds and, depending on the image edge, you might get negative values or values greater than 1 for the left or top values.
Celebrity
- Celebrity
object
: Provides information about a celebrity recognized by the operation.- Face ComparedFace
- Id RekognitionUniqueId
- MatchConfidence Percent
- Name String
- Urls Urls
CelebrityDetail
- CelebrityDetail
object
: Information about a recognized celebrity.- BoundingBox BoundingBox
- Confidence Percent
- Face FaceDetail
- Id RekognitionUniqueId
- Name String
- Urls Urls
CelebrityList
- CelebrityList
array
- items Celebrity
CelebrityRecognition
- CelebrityRecognition
object
: Information about a detected celebrity and the time the celebrity was detected in a stored video. For more information, see .- Celebrity CelebrityDetail
- Timestamp Timestamp
CelebrityRecognitionSortBy
- CelebrityRecognitionSortBy
string
(values: ID, TIMESTAMP)
CelebrityRecognitions
- CelebrityRecognitions
array
- items CelebrityRecognition
ClientRequestToken
- ClientRequestToken
string
CollectionId
- CollectionId
string
CollectionIdList
- CollectionIdList
array
- items CollectionId
CompareFacesMatch
- CompareFacesMatch
object
: Provides information about a face in a target image that matches the source image face analysed by CompareFaces. The Face property contains the bounding box of the face in the target image. The Similarity property is the confidence that the source image face matches the face in the bounding box.- Face ComparedFace
- Similarity Percent
CompareFacesMatchList
- CompareFacesMatchList
array
- items CompareFacesMatch
CompareFacesRequest
- CompareFacesRequest
object
CompareFacesResponse
- CompareFacesResponse
object
- FaceMatches CompareFacesMatchList
- SourceImageFace ComparedSourceImageFace
- SourceImageOrientationCorrection OrientationCorrection
- TargetImageOrientationCorrection OrientationCorrection
- UnmatchedFaces CompareFacesUnmatchList
CompareFacesUnmatchList
- CompareFacesUnmatchList
array
- items ComparedFace
ComparedFace
- ComparedFace
object
: Provides face metadata for target image faces that are analysed by CompareFaces and RecognizeCelebrities.- BoundingBox BoundingBox
- Confidence Percent
- Landmarks Landmarks
- Pose Pose
- Quality ImageQuality
ComparedFaceList
- ComparedFaceList
array
- items ComparedFace
ComparedSourceImageFace
- ComparedSourceImageFace
object
: Type that describes the face Amazon Rekognition chose to compare with the faces in the target. This contains a bounding box for the selected face and confidence level that the bounding box contains a face. Note that Amazon Rekognition selects the largest face in the source image for this comparison.- BoundingBox BoundingBox
- Confidence Percent
ContentModerationDetection
- ContentModerationDetection
object
: Information about a moderation label detection in a stored video.- ModerationLabel ModerationLabel
- Timestamp Timestamp
ContentModerationDetections
- ContentModerationDetections
array
ContentModerationSortBy
- ContentModerationSortBy
string
(values: NAME, TIMESTAMP)
CreateCollectionRequest
- CreateCollectionRequest
object
- CollectionId required CollectionId
CreateCollectionResponse
CreateStreamProcessorRequest
- CreateStreamProcessorRequest
object
- Input required StreamProcessorInput
- Name required StreamProcessorName
- Output required StreamProcessorOutput
- RoleArn required RoleArn
- Settings required StreamProcessorSettings
CreateStreamProcessorResponse
- CreateStreamProcessorResponse
object
- StreamProcessorArn StreamProcessorArn
DateTime
- DateTime
string
Degree
- Degree
number
DeleteCollectionRequest
- DeleteCollectionRequest
object
- CollectionId required CollectionId
DeleteCollectionResponse
- DeleteCollectionResponse
object
- StatusCode UInteger
DeleteFacesRequest
- DeleteFacesRequest
object
- CollectionId required CollectionId
- FaceIds required FaceIdList
DeleteFacesResponse
- DeleteFacesResponse
object
- DeletedFaces FaceIdList
DeleteStreamProcessorRequest
- DeleteStreamProcessorRequest
object
- Name required StreamProcessorName
DeleteStreamProcessorResponse
- DeleteStreamProcessorResponse
object
DescribeStreamProcessorRequest
- DescribeStreamProcessorRequest
object
- Name required StreamProcessorName
DescribeStreamProcessorResponse
- DescribeStreamProcessorResponse
object
- CreationTimestamp DateTime
- Input StreamProcessorInput
- LastUpdateTimestamp DateTime
- Name StreamProcessorName
- Output StreamProcessorOutput
- RoleArn RoleArn
- Settings StreamProcessorSettings
- Status StreamProcessorStatus
- StatusMessage String
- StreamProcessorArn StreamProcessorArn
DetectFacesRequest
- DetectFacesRequest
object
- Attributes Attributes
- Image required Image
DetectFacesResponse
- DetectFacesResponse
object
- FaceDetails FaceDetailList
- OrientationCorrection OrientationCorrection
DetectLabelsRequest
DetectLabelsResponse
- DetectLabelsResponse
object
- Labels Labels
- OrientationCorrection OrientationCorrection
DetectModerationLabelsRequest
DetectModerationLabelsResponse
- DetectModerationLabelsResponse
object
- ModerationLabels ModerationLabels
DetectTextRequest
- DetectTextRequest
object
- Image required Image
DetectTextResponse
- DetectTextResponse
object
- TextDetections TextDetectionList
Emotion
- Emotion
object
: The emotions detected on the face, and the confidence level in the determination. For example, HAPPY, SAD, and ANGRY.- Confidence Percent
- Type EmotionName
EmotionName
- EmotionName
string
(values: HAPPY, SAD, ANGRY, CONFUSED, DISGUSTED, SURPRISED, CALM, UNKNOWN)
Emotions
- Emotions
array
- items Emotion
ExternalImageId
- ExternalImageId
string
EyeOpen
- EyeOpen
object
: Indicates whether or not the eyes on the face are open, and the confidence level in the determination.
Eyeglasses
- Eyeglasses
object
: Indicates whether or not the face is wearing eye glasses, and the confidence level in the determination.
Face
- Face
object
: Describes the face properties such as the bounding box, face ID, image ID of the input image, and external image ID that you assigned.- BoundingBox BoundingBox
- Confidence Percent
- ExternalImageId ExternalImageId
- FaceId FaceId
- ImageId ImageId
FaceAttributes
- FaceAttributes
string
(values: DEFAULT, ALL)
FaceDetail
- FaceDetail
object
: Structure containing attributes of the face that the algorithm detected.- AgeRange AgeRange
- Beard Beard
- BoundingBox BoundingBox
- Confidence Percent
- Emotions Emotions
- Eyeglasses Eyeglasses
- EyesOpen EyeOpen
- Gender Gender
- Landmarks Landmarks
- MouthOpen MouthOpen
- Mustache Mustache
- Pose Pose
- Quality ImageQuality
- Smile Smile
- Sunglasses Sunglasses
FaceDetailList
- FaceDetailList
array
- items FaceDetail
FaceDetection
- FaceDetection
object
: Information about a face detected in a video analysis request and the time the face was detected in the video.- Face FaceDetail
- Timestamp Timestamp
FaceDetections
- FaceDetections
array
- items FaceDetection
FaceId
- FaceId
string
FaceIdList
- FaceIdList
array
- items FaceId
FaceList
- FaceList
array
- items Face
FaceMatch
- FaceMatch
object
: Provides face metadata. In addition, it also provides the confidence in the match of this face with the input face.
FaceMatchList
- FaceMatchList
array
- items FaceMatch
FaceModelVersionList
- FaceModelVersionList
array
- items String
FaceRecord
- FaceRecord
object
: Object containing both the face metadata (stored in the back-end database) and facial attributes that are detected but aren't stored in the database.- Face Face
- FaceDetail FaceDetail
FaceRecordList
- FaceRecordList
array
- items FaceRecord
FaceSearchSettings
- FaceSearchSettings
object
: Input face recognition parameters for an Amazon Rekognition stream processor. FaceRecognitionSettings is a request parameter for .- CollectionId CollectionId
- FaceMatchThreshold Percent
FaceSearchSortBy
- FaceSearchSortBy
string
(values: INDEX, TIMESTAMP)
Float
- Float
number
Gender
- Gender
object
: Gender of the face and the confidence level in the determination.- Confidence Percent
- Value GenderType
GenderType
- GenderType
string
(values: Male, Female)
Geometry
- Geometry
object
: Information about where text detected by is located on an image.- BoundingBox BoundingBox
- Polygon Polygon
GetCelebrityInfoRequest
- GetCelebrityInfoRequest
object
- Id required RekognitionUniqueId
GetCelebrityInfoResponse
GetCelebrityRecognitionRequest
- GetCelebrityRecognitionRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy CelebrityRecognitionSortBy
GetCelebrityRecognitionResponse
- GetCelebrityRecognitionResponse
object
- Celebrities CelebrityRecognitions
- JobStatus VideoJobStatus
- NextToken PaginationToken
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
GetContentModerationRequest
- GetContentModerationRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy ContentModerationSortBy
GetContentModerationResponse
- GetContentModerationResponse
object
- JobStatus VideoJobStatus
- ModerationLabels ContentModerationDetections
- NextToken PaginationToken
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
GetFaceDetectionRequest
- GetFaceDetectionRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
GetFaceDetectionResponse
- GetFaceDetectionResponse
object
- Faces FaceDetections
- JobStatus VideoJobStatus
- NextToken PaginationToken
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
GetFaceSearchRequest
- GetFaceSearchRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy FaceSearchSortBy
GetFaceSearchResponse
- GetFaceSearchResponse
object
- JobStatus VideoJobStatus
- NextToken PaginationToken
- Persons PersonMatches
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
GetLabelDetectionRequest
- GetLabelDetectionRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy LabelDetectionSortBy
GetLabelDetectionResponse
- GetLabelDetectionResponse
object
- JobStatus VideoJobStatus
- Labels LabelDetections
- NextToken PaginationToken
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
GetPersonTrackingRequest
- GetPersonTrackingRequest
object
- JobId required JobId
- MaxResults MaxResults
- NextToken PaginationToken
- SortBy PersonTrackingSortBy
GetPersonTrackingResponse
- GetPersonTrackingResponse
object
- JobStatus VideoJobStatus
- NextToken PaginationToken
- Persons PersonDetections
- StatusMessage StatusMessage
- VideoMetadata VideoMetadata
IdempotentParameterMismatchException
- IdempotentParameterMismatchException
object
: A ClientRequestToken input parameter was reused with an operation, but at least one of the other input parameters is different from the previous call to the operation.
Image
- Image
object
: Provides the input image either as bytes or an S3 object. You pass image bytes to a Rekognition API operation by using the Bytes property. For example, you would use the Bytes property to pass an image loaded from a local file system. Image bytes passed by using the Bytes property must be base64-encoded. Your code may not need to encode image bytes if you are using an AWS SDK to call Rekognition API operations. For more information, see images-bytes. You pass images stored in an S3 bucket to a Rekognition API operation by using the S3Object property. Images stored in an S3 bucket do not need to be base64-encoded. The region for the S3 bucket containing the S3 object must match the region you use for Amazon Rekognition operations. If you use the Amazon CLI to call Amazon Rekognition operations, passing image bytes using the Bytes property is not supported. You must first upload the image to an Amazon S3 bucket and then call the operation using the S3Object property. For Amazon Rekognition to process an S3 object, the user must have permission to access the S3 object. For more information, see manage-access-resource-policies.
ImageBlob
- ImageBlob
string
ImageId
- ImageId
string
ImageQuality
- ImageQuality
object
: Identifies face image brightness and sharpness.
ImageTooLargeException
- ImageTooLargeException
object
: The input image size exceeds the allowed limit. For more information, see limits.
IndexFacesRequest
- IndexFacesRequest
object
- CollectionId required CollectionId
- DetectionAttributes Attributes
- ExternalImageId ExternalImageId
- Image required Image
IndexFacesResponse
- IndexFacesResponse
object
- FaceModelVersion String
- FaceRecords FaceRecordList
- OrientationCorrection OrientationCorrection
InternalServerError
- InternalServerError
object
: Amazon Rekognition experienced a service issue. Try your call again.
InvalidImageFormatException
- InvalidImageFormatException
object
: The provided image format is not supported.
InvalidPaginationTokenException
- InvalidPaginationTokenException
object
: Pagination token in the request is not valid.
InvalidParameterException
- InvalidParameterException
object
: Input parameter violated a constraint. Validate your parameter before calling the API operation again.
InvalidS3ObjectException
- InvalidS3ObjectException
object
: Amazon Rekognition is unable to access the S3 object specified in the request.
JobId
- JobId
string
JobTag
- JobTag
string
KinesisDataArn
- KinesisDataArn
string
KinesisDataStream
- KinesisDataStream
object
: The Kinesis data stream Amazon Rekognition to which the analysis results of a Amazon Rekognition stream processor are streamed. For more information, see .- Arn KinesisDataArn
KinesisVideoArn
- KinesisVideoArn
string
KinesisVideoStream
- KinesisVideoStream
object
: Kinesis video stream stream that provides the source streaming video for a Rekognition Video stream processor. For more information, see .- Arn KinesisVideoArn
Label
- Label
object
: Structure containing details about the detected label, including name, and level of confidence.
LabelDetection
- LabelDetection
object
: Information about a label detected in a video analysis request and the time the label was detected in the video.
LabelDetectionSortBy
- LabelDetectionSortBy
string
(values: NAME, TIMESTAMP)
LabelDetections
- LabelDetections
array
- items LabelDetection
Labels
- Labels
array
- items Label
Landmark
- Landmark
object
: Indicates the location of the landmark on the face.- Type LandmarkType
- X Float
- Y Float
LandmarkType
- LandmarkType
string
(values: eyeLeft, eyeRight, nose, mouthLeft, mouthRight, leftEyeBrowLeft, leftEyeBrowRight, leftEyeBrowUp, rightEyeBrowLeft, rightEyeBrowRight, rightEyeBrowUp, leftEyeLeft, leftEyeRight, leftEyeUp, leftEyeDown, rightEyeLeft, rightEyeRight, rightEyeUp, rightEyeDown, noseLeft, noseRight, mouthUp, mouthDown, leftPupil, rightPupil)
Landmarks
- Landmarks
array
- items Landmark
LimitExceededException
- LimitExceededException
object
:
ListCollectionsRequest
- ListCollectionsRequest
object
- MaxResults PageSize
- NextToken PaginationToken
ListCollectionsResponse
- ListCollectionsResponse
object
- CollectionIds CollectionIdList
- FaceModelVersions FaceModelVersionList
- NextToken PaginationToken
ListFacesRequest
- ListFacesRequest
object
- CollectionId required CollectionId
- MaxResults PageSize
- NextToken PaginationToken
ListFacesResponse
ListStreamProcessorsRequest
- ListStreamProcessorsRequest
object
- MaxResults MaxResults
- NextToken PaginationToken
ListStreamProcessorsResponse
- ListStreamProcessorsResponse
object
- NextToken PaginationToken
- StreamProcessors StreamProcessorList
MaxFaces
- MaxFaces
integer
MaxResults
- MaxResults
integer
ModerationLabel
- ModerationLabel
object
: Provides information about a single type of moderated content found in an image or video. Each type of moderated content has a label within a hierarchical taxonomy. For more information, see moderation.
ModerationLabels
- ModerationLabels
array
- items ModerationLabel
MouthOpen
- MouthOpen
object
: Indicates whether or not the mouth on the face is open, and the confidence level in the determination.
Mustache
- Mustache
object
: Indicates whether or not the face has a mustache, and the confidence level in the determination.
NotificationChannel
- NotificationChannel
object
: The Amazon Simple Notification Service topic to which Amazon Rekognition publishes the completion status of a video analysis operation. For more information, see api-video.- RoleArn required RoleArn
- SNSTopicArn required SNSTopicArn
OrientationCorrection
- OrientationCorrection
string
(values: ROTATE_0, ROTATE_90, ROTATE_180, ROTATE_270)
PageSize
- PageSize
integer
PaginationToken
- PaginationToken
string
Percent
- Percent
number
PersonDetail
- PersonDetail
object
: Details about a person detected in a video analysis request.- BoundingBox BoundingBox
- Face FaceDetail
- Index PersonIndex
PersonDetection
- PersonDetection
object
: Details and tracking information for a single time a person is tracked in a video. Amazon Rekognition operations that track persons return an array of PersonDetection objects with elements for each time a person is tracked in a video. For more information, see .- Person PersonDetail
- Timestamp Timestamp
PersonDetections
- PersonDetections
array
- items PersonDetection
PersonIndex
- PersonIndex
integer
PersonMatch
- PersonMatch
object
: Information about a person whose face matches a face(s) in a Amazon Rekognition collection. Includes information about the faces in the Amazon Rekognition collection (,information about the person (PersonDetail) and the timestamp for when the person was detected in a video. An array of PersonMatch objects is returned by .- FaceMatches FaceMatchList
- Person PersonDetail
- Timestamp Timestamp
PersonMatches
- PersonMatches
array
- items PersonMatch
PersonTrackingSortBy
- PersonTrackingSortBy
string
(values: INDEX, TIMESTAMP)
Point
- Point
object
: The X and Y coordinates of a point on an image. The X and Y values returned are ratios of the overall image size. For example, if the input image is 700x200 and the operation returns X=0.5 and Y=0.25, then the point is at the (350,50) pixel coordinate on the image. An array of Point objects, Polygon, is returned by . Polygon represents a fine-grained polygon around detected text. For more information, see .
Polygon
- Polygon
array
- items Point
Pose
- Pose
object
: Indicates the pose of the face as determined by its pitch, roll, and yaw.
ProvisionedThroughputExceededException
- ProvisionedThroughputExceededException
object
: The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition.
RecognizeCelebritiesRequest
- RecognizeCelebritiesRequest
object
- Image required Image
RecognizeCelebritiesResponse
- RecognizeCelebritiesResponse
object
- CelebrityFaces CelebrityList
- OrientationCorrection OrientationCorrection
- UnrecognizedFaces ComparedFaceList
RekognitionUniqueId
- RekognitionUniqueId
string
ResourceAlreadyExistsException
- ResourceAlreadyExistsException
object
: A collection with the specified ID already exists.
ResourceInUseException
- ResourceInUseException
object
:
ResourceNotFoundException
- ResourceNotFoundException
object
: The collection specified in the request cannot be found.
RoleArn
- RoleArn
string
S3Bucket
- S3Bucket
string
S3Object
- S3Object
object
: Provides the S3 bucket name and object name. The region for the S3 bucket containing the S3 object must match the region you use for Amazon Rekognition operations. For Amazon Rekognition to process an S3 object, the user must have permission to access the S3 object. For more information, see manage-access-resource-policies.- Bucket S3Bucket
- Name S3ObjectName
- Version S3ObjectVersion
S3ObjectName
- S3ObjectName
string
S3ObjectVersion
- S3ObjectVersion
string
SNSTopicArn
- SNSTopicArn
string
SearchFacesByImageRequest
- SearchFacesByImageRequest
object
- CollectionId required CollectionId
- FaceMatchThreshold Percent
- Image required Image
- MaxFaces MaxFaces
SearchFacesByImageResponse
- SearchFacesByImageResponse
object
- FaceMatches FaceMatchList
- FaceModelVersion String
- SearchedFaceBoundingBox BoundingBox
- SearchedFaceConfidence Percent
SearchFacesRequest
- SearchFacesRequest
object
- CollectionId required CollectionId
- FaceId required FaceId
- FaceMatchThreshold Percent
- MaxFaces MaxFaces
SearchFacesResponse
- SearchFacesResponse
object
- FaceMatches FaceMatchList
- FaceModelVersion String
- SearchedFaceId FaceId
Smile
- Smile
object
: Indicates whether or not the face is smiling, and the confidence level in the determination.
StartCelebrityRecognitionRequest
- StartCelebrityRecognitionRequest
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
StartCelebrityRecognitionResponse
- StartCelebrityRecognitionResponse
object
- JobId JobId
StartContentModerationRequest
- StartContentModerationRequest
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- MinConfidence Percent
- NotificationChannel NotificationChannel
- Video required Video
StartContentModerationResponse
- StartContentModerationResponse
object
- JobId JobId
StartFaceDetectionRequest
- StartFaceDetectionRequest
object
- ClientRequestToken ClientRequestToken
- FaceAttributes FaceAttributes
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
StartFaceDetectionResponse
- StartFaceDetectionResponse
object
- JobId JobId
StartFaceSearchRequest
- StartFaceSearchRequest
object
- ClientRequestToken ClientRequestToken
- CollectionId required CollectionId
- FaceMatchThreshold Percent
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
StartFaceSearchResponse
- StartFaceSearchResponse
object
- JobId JobId
StartLabelDetectionRequest
- StartLabelDetectionRequest
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- MinConfidence Percent
- NotificationChannel NotificationChannel
- Video required Video
StartLabelDetectionResponse
- StartLabelDetectionResponse
object
- JobId JobId
StartPersonTrackingRequest
- StartPersonTrackingRequest
object
- ClientRequestToken ClientRequestToken
- JobTag JobTag
- NotificationChannel NotificationChannel
- Video required Video
StartPersonTrackingResponse
- StartPersonTrackingResponse
object
- JobId JobId
StartStreamProcessorRequest
- StartStreamProcessorRequest
object
- Name required StreamProcessorName
StartStreamProcessorResponse
- StartStreamProcessorResponse
object
StatusMessage
- StatusMessage
string
StopStreamProcessorRequest
- StopStreamProcessorRequest
object
- Name required StreamProcessorName
StopStreamProcessorResponse
- StopStreamProcessorResponse
object
StreamProcessor
- StreamProcessor
object
: An object that recognizes faces in a streaming video. An Amazon Rekognition stream processor is created by a call to . The request parameters for CreateStreamProcessor describe the Kinesis video stream source for the streaming video, face recognition parameters, and where to stream the analysis resullts.- Name StreamProcessorName
- Status StreamProcessorStatus
StreamProcessorArn
- StreamProcessorArn
string
StreamProcessorInput
- StreamProcessorInput
object
: Information about the source streaming video.- KinesisVideoStream KinesisVideoStream
StreamProcessorList
- StreamProcessorList
array
- items StreamProcessor
StreamProcessorName
- StreamProcessorName
string
StreamProcessorOutput
- StreamProcessorOutput
object
: Information about the Amazon Kinesis Data Streams stream to which a Rekognition Video stream processor streams the results of a video analysis. For more information, see .- KinesisDataStream KinesisDataStream
StreamProcessorSettings
- StreamProcessorSettings
object
: Input parameters used to recognize faces in a streaming video analyzed by a Amazon Rekognition stream processor.- FaceSearch FaceSearchSettings
StreamProcessorStatus
- StreamProcessorStatus
string
(values: STOPPED, STARTING, RUNNING, FAILED, STOPPING)
String
- String
string
Sunglasses
- Sunglasses
object
: Indicates whether or not the face is wearing sunglasses, and the confidence level in the determination.
TextDetection
- TextDetection
object
: Information about a word or line of text detected by . The DetectedText field contains the text that Amazon Rekognition detected in the image. Every word and line has an identifier (Id). Each word belongs to a line and has a parent identifier (ParentId) that identifies the line of text in which the word appears. The word Id is also an index for the word within a line of words. For more information, see text-detection.
TextDetectionList
- TextDetectionList
array
- items TextDetection
TextTypes
- TextTypes
string
(values: LINE, WORD)
ThrottlingException
- ThrottlingException
object
: Amazon Rekognition is temporarily unable to process the request. Try your call again.
Timestamp
- Timestamp
integer
UInteger
- UInteger
integer
ULong
- ULong
integer
Url
- Url
string
Urls
- Urls
array
- items Url
Video
- Video
object
: Video file stored in an Amazon S3 bucket. Amazon Rekognition video start operations such as use Video to specify a video for analysis. The supported file formats are .mp4, .mov and .avi.- S3Object S3Object
VideoJobStatus
- VideoJobStatus
string
(values: IN_PROGRESS, SUCCEEDED, FAILED)
VideoMetadata
- VideoMetadata
object
: Information about a video that Amazon Rekognition analyzed. Videometadata is returned in every page of paginated responses from a Amazon Rekognition video operation.
VideoTooLargeException
- VideoTooLargeException
object
: The file size or duration of the supplied media is too large. The maximum file size is 8GB. The maximum duration is 2 hours.