Class: AWS.Rekognition
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.Rekognition
- Identifier:
- rekognition
- API Version:
- 2016-06-27
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
This is the API Reference for Amazon Rekognition Image, Amazon Rekognition Custom Labels, Amazon Rekognition Stored Video, Amazon Rekognition Streaming Video. It provides descriptions of actions, data types, common parameters, and common errors.
Amazon Rekognition Image
Amazon Rekognition Custom Labels
Amazon Rekognition Video Stored Video
Amazon Rekognition Video Streaming Video
Sending a Request Using Rekognition
var rekognition = new AWS.Rekognition();
rekognition.associateFaces(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the Rekognition object uses this specific API, you can
construct the object by passing the apiVersion option to the constructor:
var rekognition = new AWS.Rekognition({apiVersion: '2016-06-27'});
You can also set the API version globally in AWS.config.apiVersions using
the rekognition service identifier:
AWS.config.apiVersions = {
rekognition: '2016-06-27',
// other service API versions
};
var rekognition = new AWS.Rekognition();
Waiter Resource States
This service supports a list of resource states that can be polled using the waitFor() method. The resource states are:
projectVersionTrainingCompleted, projectVersionRunning
Constructor Summary collapse
-
new AWS.Rekognition(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
associateFaces(params = {}, callback) ⇒ AWS.Request
Associates one or more faces with an existing UserID.
-
compareFaces(params = {}, callback) ⇒ AWS.Request
Compares a face in the source input image with each of the 100 largest faces detected in the target input image.
-
copyProjectVersion(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.
- createCollection(params = {}, callback) ⇒ AWS.Request
Creates a collection in an AWS Region.
- createDataset(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- createFaceLivenessSession(params = {}, callback) ⇒ AWS.Request
This API operation initiates a Face Liveness session.
- createProject(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon Rekognition project.
- createProjectVersion(params = {}, callback) ⇒ AWS.Request
Creates a new version of Amazon Rekognition project (like a Custom Labels model or a custom adapter) and begins training.
- createStreamProcessor(params = {}, callback) ⇒ AWS.Request
Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces or to detect labels in a streaming video.
Amazon Rekognition Video is a consumer of live video from Amazon Kinesis Video Streams.
- createUser(params = {}, callback) ⇒ AWS.Request
Creates a new User within a collection specified by
CollectionId.- deleteCollection(params = {}, callback) ⇒ AWS.Request
Deletes the specified collection.
- deleteDataset(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- deleteFaces(params = {}, callback) ⇒ AWS.Request
Deletes faces from a collection.
- deleteProject(params = {}, callback) ⇒ AWS.Request
Deletes a Amazon Rekognition project.
- deleteProjectPolicy(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- deleteProjectVersion(params = {}, callback) ⇒ AWS.Request
Deletes a Rekognition project model or project version, like a Amazon Rekognition Custom Labels model or a custom adapter.
You can't delete a project version if it is running or if it is training.
- deleteStreamProcessor(params = {}, callback) ⇒ AWS.Request
Deletes the stream processor identified by
Name.- deleteUser(params = {}, callback) ⇒ AWS.Request
Deletes the specified UserID within the collection.
- describeCollection(params = {}, callback) ⇒ AWS.Request
Describes the specified collection.
- describeDataset(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- describeProjects(params = {}, callback) ⇒ AWS.Request
Gets information about your Rekognition projects.
This operation requires permissions to perform the
.rekognition:DescribeProjectsaction.- describeProjectVersions(params = {}, callback) ⇒ AWS.Request
Lists and describes the versions of an Amazon Rekognition project.
- describeStreamProcessor(params = {}, callback) ⇒ AWS.Request
Provides information about a stream processor created by CreateStreamProcessor.
- detectCustomLabels(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- detectFaces(params = {}, callback) ⇒ AWS.Request
Detects faces within an image that is provided as input.
DetectFacesdetects the 100 largest faces in the image.- detectLabels(params = {}, callback) ⇒ AWS.Request
Detects instances of real-world entities within an image (JPEG or PNG) provided as input.
- detectModerationLabels(params = {}, callback) ⇒ AWS.Request
Detects unsafe content in a specified JPEG or PNG format image.
- detectProtectiveEquipment(params = {}, callback) ⇒ AWS.Request
Detects Personal Protective Equipment (PPE) worn by people detected in an image.
- detectText(params = {}, callback) ⇒ AWS.Request
Detects text in the input image and converts it into machine-readable text.
Pass the input image as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket.
- disassociateFaces(params = {}, callback) ⇒ AWS.Request
Removes the association between a
Facesupplied in an array ofFaceIdsand the User.- distributeDatasetEntries(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- getCelebrityInfo(params = {}, callback) ⇒ AWS.Request
Gets the name and additional information about a celebrity based on their Amazon Rekognition ID.
- getCelebrityRecognition(params = {}, callback) ⇒ AWS.Request
Gets the celebrity recognition results for a Amazon Rekognition Video analysis started by StartCelebrityRecognition.
Celebrity recognition in a video is an asynchronous operation.
- getContentModeration(params = {}, callback) ⇒ AWS.Request
Gets the inappropriate, unwanted, or offensive content analysis results for a Amazon Rekognition Video analysis started by StartContentModeration.
- getFaceDetection(params = {}, callback) ⇒ AWS.Request
Gets face detection results for a Amazon Rekognition Video analysis started by StartFaceDetection.
Face detection with Amazon Rekognition Video is an asynchronous operation.
- getFaceLivenessSessionResults(params = {}, callback) ⇒ AWS.Request
Retrieves the results of a specific Face Liveness session.
- getFaceSearch(params = {}, callback) ⇒ AWS.Request
Gets the face search results for Amazon Rekognition Video face search started by StartFaceSearch.
- getLabelDetection(params = {}, callback) ⇒ AWS.Request
Gets the label detection results of a Amazon Rekognition Video analysis started by StartLabelDetection.
- getMediaAnalysisJob(params = {}, callback) ⇒ AWS.Request
Retrieves the results for a given media analysis job.
- getPersonTracking(params = {}, callback) ⇒ AWS.Request
Gets the path tracking results of a Amazon Rekognition Video analysis started by StartPersonTracking.
The person path tracking operation is started by a call to
StartPersonTrackingwhich returns a job identifier (JobId).- getSegmentDetection(params = {}, callback) ⇒ AWS.Request
Gets the segment detection results of a Amazon Rekognition Video analysis started by StartSegmentDetection.
Segment detection with Amazon Rekognition Video is an asynchronous operation.
- getTextDetection(params = {}, callback) ⇒ AWS.Request
Gets the text detection results of a Amazon Rekognition Video analysis started by StartTextDetection.
Text detection with Amazon Rekognition Video is an asynchronous operation.
- indexFaces(params = {}, callback) ⇒ AWS.Request
Detects faces in the input image and adds them to the specified collection.
- listCollections(params = {}, callback) ⇒ AWS.Request
Returns list of collection IDs in your account.
- listDatasetEntries(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- listDatasetLabels(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- listFaces(params = {}, callback) ⇒ AWS.Request
Returns metadata for faces in the specified collection.
- listMediaAnalysisJobs(params = {}, callback) ⇒ AWS.Request
Returns a list of media analysis jobs.
- listProjectPolicies(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- listStreamProcessors(params = {}, callback) ⇒ AWS.Request
Gets a list of stream processors that you have created with CreateStreamProcessor.
- listTagsForResource(params = {}, callback) ⇒ AWS.Request
Returns a list of tags in an Amazon Rekognition collection, stream processor, or Custom Labels model.
- listUsers(params = {}, callback) ⇒ AWS.Request
Returns metadata of the User such as
UserIDin the specified collection.- putProjectPolicy(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- recognizeCelebrities(params = {}, callback) ⇒ AWS.Request
Returns an array of celebrities recognized in the input image.
- searchFaces(params = {}, callback) ⇒ AWS.Request
For a given input face ID, searches for matching faces in the collection the face belongs to.
- searchFacesByImage(params = {}, callback) ⇒ AWS.Request
For a given input image, first detects the largest face in the image, and then searches the specified collection for matching faces.
- searchUsers(params = {}, callback) ⇒ AWS.Request
Searches for UserIDs within a collection based on a
FaceIdorUserId.- searchUsersByImage(params = {}, callback) ⇒ AWS.Request
Searches for UserIDs using a supplied image.
- startCelebrityRecognition(params = {}, callback) ⇒ AWS.Request
Starts asynchronous recognition of celebrities in a stored video.
Amazon Rekognition Video can detect celebrities in a video must be stored in an Amazon S3 bucket.
- startContentModeration(params = {}, callback) ⇒ AWS.Request
Starts asynchronous detection of inappropriate, unwanted, or offensive content in a stored video.
- startFaceDetection(params = {}, callback) ⇒ AWS.Request
Starts asynchronous detection of faces in a stored video.
Amazon Rekognition Video can detect faces in a video stored in an Amazon S3 bucket.
- startFaceSearch(params = {}, callback) ⇒ AWS.Request
Starts the asynchronous search for faces in a collection that match the faces of persons detected in a stored video.
The video must be stored in an Amazon S3 bucket.
- startLabelDetection(params = {}, callback) ⇒ AWS.Request
Starts asynchronous detection of labels in a stored video.
Amazon Rekognition Video can detect labels in a video.
- startMediaAnalysisJob(params = {}, callback) ⇒ AWS.Request
Initiates a new media analysis job.
- startPersonTracking(params = {}, callback) ⇒ AWS.Request
Starts the asynchronous tracking of a person's path in a stored video.
Amazon Rekognition Video can track the path of people in a video stored in an Amazon S3 bucket.
- startProjectVersion(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- startSegmentDetection(params = {}, callback) ⇒ AWS.Request
Starts asynchronous detection of segment detection in a stored video.
Amazon Rekognition Video can detect segments in a video stored in an Amazon S3 bucket.
- startStreamProcessor(params = {}, callback) ⇒ AWS.Request
Starts processing a stream processor.
- startTextDetection(params = {}, callback) ⇒ AWS.Request
Starts asynchronous detection of text in a stored video.
Amazon Rekognition Video can detect text in a video stored in an Amazon S3 bucket.
- stopProjectVersion(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- stopStreamProcessor(params = {}, callback) ⇒ AWS.Request
Stops a running stream processor that was created by CreateStreamProcessor.
.
- tagResource(params = {}, callback) ⇒ AWS.Request
Adds one or more key-value tags to an Amazon Rekognition collection, stream processor, or Custom Labels model.
- untagResource(params = {}, callback) ⇒ AWS.Request
Removes one or more tags from an Amazon Rekognition collection, stream processor, or Custom Labels model.
- updateDatasetEntries(params = {}, callback) ⇒ AWS.Request
Note: This operation applies only to Amazon Rekognition Custom Labels.- updateStreamProcessor(params = {}, callback) ⇒ AWS.Request
Allows you to update a stream processor.
- waitFor(state, params = {}, callback) ⇒ AWS.Request
- createCollection(params = {}, callback) ⇒ AWS.Request