Use this documentation to install and configure Semarchy's plug-in for Amazon Rekognition Moderating Images service.
Overview
Everybody likes using artificial intelligence and machine learning these days, don't they? We're no different. Semarchy is jumping on the AI bandwagon!
Amazon has been democratizing AI and selling their resulting services. We can benefit from the new Amazon Rekognition service that analyzes images sent to its API and returns information about the image, such as detecting adult content and labels for the content of the images.
This particular article outlines a plug-in enricher Semarchy has built to take advantage of Amazon Rekognition's Moderating Images service that tells you whether there is any adult offensive content in an image.
Plug-ins features
Semarchy's plug-in takes an S3 image URL and passes it into Rekognition which classifies the image according to its Moderating Image service.
See Amazon's documentation for details about this service: Moderating Images documentation
Plug-in Prerequisites
- Download the plug-in binary file using this link: Download plug-in.
- Follow these instructions for installing your plug-in: How to install an external plug-in.
- Prior to using this plug-in, you will need to set up an IAM user with the right IAM roles to access the Amazon Rekognition service. Follow the instructions on Amazon Rekognition's documentation: Authentication and Access Control for Amazon Rekognition.
Plug-In Reference Guide
The following sections detail the parameters, inputs and outputs of the plugin.
Advanced Configuration
The plug-ins enrichers provide options for optimizing and configuring their execution.
| Configuration Name | Description |
|---|---|
| Max Retries | If the execution of the plug-in fails, it is repeated for this number of times. |
| Behavior on Error | If the execution still fails after the Max Retries have been attempted, the plug-in either skips the current record, skips the entire enrichment task, or stops the whole job, depending on this property. |
| Thread Pool Size | This property defines the number of parallel threads used by this plug-in. This option is taken into account if the plug-in used is thread safe and declared as such. |
Plug-in Parameters
The following table lists the plug-in parameters.
| Parameter Name | Mandatory | Type | Description | Sample Value |
|---|---|---|---|---|
| AWS Access Key ID | Yes | String | Provide the Access Key ID which is generated when a user is created in AWS Identity and Access Management (IAM). | AKIAIOSFODNN7EXAMPLE |
| AWS Secret Access Key | Yes | String | Provide the Secret Access Key which is generated when a user is created in AWS Identity and Access Management (IAM). | wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |
| Region | Yes | String | Specify in which region you want to use Amazon Rekognition. For example, valid regions include: us-east-1 (US East Northern Virginia), us-west-2 (US West Oregon) and eu-west-1 (EU Ireland) regions. See Amazon docs. | us-east-1 |
Plug-in Inputs
The following table lists the plug-in inputs.
| Parameter Name | Mandatory | Type | Description | Sample Value |
|---|---|---|---|---|
| Image URL | Yes | String | Image stored in S3 to send to Amazon Rekognition for moderation | https://s3.amazonaws.com/semarchy-tutorials/10001-MAIN.jpg |
| Minimum confidence | No | Float | Specifies the minimum confidence level for the labels to return. Amazon Rekognition doesn't return any labels with a confidence level lower than this specified value. Valid Range: Min 0. Max 100. Plug-in defaults to 0. | 50 |
Plug-in Outputs
The following tables list the plug-in outputs.
The output consists of a result status, boolean classification, and confidence scores.
| Parameter Name | Type | Description | Sample Value |
|---|---|---|---|
| Is Explicit Nudity | Boolean | ||
| Explicit Nudity Confidence Score | Float | ||
| Is Nudity | Boolean | ||
| Nudity Confidence Score | Float | ||
| Is Graphic Male Nudity | Boolean | ||
| Graphic Male Nudity Confidence Score | Float | ||
| Is Graphic Female Nudity | Boolean | ||
| Graphic Female Nudity Confidence Score | Float | ||
| Is Sexual Activity | Boolean | ||
| Sexual Activity Confidence Score | Float | ||
| Is Partial Nudity | Boolean | ||
| Partial Nudity Confidence Score | Float | ||
| Is Suggestive | |||
| Suggestive Confidence Score | |||
| Is Female Swimwear Or Underwear | |||
| Female Swimwear Or Underwear Confidence Score | |||
| Is Male Swimwear Or Underwear | |||
| Male Swimwear Or Underwear Confidence Score | |||
| Is Revealing Clothes | |||
| Revealing Clothes Confidence Score | |||
| Status code |
'1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as explicit nudity (top-level category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the explicit nudity label. | |
'1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as nudity (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the nudity label. | |
I | '1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as graphic male nudity (child category). |
97.06847381591797 | Float | Estimated confidence in the accuracy of the graphic male nudity label. | |
'1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as graphic female nudity (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the graphic female nudity label. | |
'1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as sexual activity (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the sexual activity label. | |
'1' | Boolean | Flag (0 or 1) indicating whether the image is labeled as partial nudity (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the partial nudity label. | |
'0' | Boolean | Flag (0 or 1) indicating whether the image is labeled as suggestive (top-level category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the suggestive label. | |
'0' | Boolean | Flag (0 or 1) indicating whether the image is labeled as female swimwear or underwear (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the female swimwear or underwear label. | |
'0' | Boolean | Flag (0 or 1) indicating whether the image is labeled as male swimwear or underwear (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the male swimwear or underwear label. | |
'0' | Boolean | Flag (0 or 1) indicating whether the image is labeled as revealing clothes (child category). | |
97.06847381591797 | Float | Estimated confidence in the accuracy of the revealing clothes label. | |
200 | String | Status of the request. |
Obtaining Help
If you have trouble with this plug-in, there are many ways to access the Semarchy Technical Support. The easiest is to email our global Technical Support Center (support@semarchy.com).
Feedback
We welcome your comments and suggestions on the quality and usefulness of this Rekognition plug-in.
If you find any error or have any suggestion for improvement, please mail support@semarchy.com.
Related articles
Filter by label
There are no items with the selected labels at this time.