Nudity Detection

FAQ / Image Moderation

Is it possible to customize the Image Moderation API to my needs?

There is no one-size-fits-all solution with Image Moderation. Expectations will vary between countries, cultures and applications.

This is why we have worked to make our API endpoints and models flexible and suitable to most needs.

You choose the models you want to apply

As you may know, we have multiple moderation models available. When you perform a request to the API, you get to choose what models to apply and how each model is used to then decide if an image should be approved, rejected or reviewed. See our Model Reference to learn more about each model output.

Each model returns fine-grained results

Our models do not return simple binary classifications (such as 'nudity' or 'no nudity'). They send you more information so that you can make a fine-grained decision on how to handle each case.

The Nudity Detection, for instance, will tell you what level of nudity it has encountered. When faced with suggestive content, we tell you exactly what the image contains, so that you can take appropriate action - or simply accept the photo.

In other words, you don't need to worry about how images get handled when they are border-line nudity. You can simply define actions for each possible situation:

Woman in bikinisAccept Reject or Review?
Bare male chestAccept Reject or Review?
Man in underwearAccept Reject or Review?
Woman in lingerieAccept Reject or Review?
Suggestive cleavageAccept Reject or Review?
MiniskirtAccept Reject or Review?
and so on...see more details

This applies to Nudity Detection but also to all the other available models.

Each moderation category is associated with a score

A score between 0 and 1 is returned for each moderation category. This value reflects the model’s confidence. A score closer to 1 indicates that the image has a higher probability of containing what the model is looking for.

With these scores, you can define thresholds to help you make a decision about the image you submitted. It could simply be to automatically reject the image using Fully Automated Moderation if the score is above a predefined value.

It could also be to review some of the submitted images using Hybrid Moderation if the score is between two predefined thresholds.

You can create custom disallow lists

Disallow Lists can help you blacklist some specific images by fingerprinting them and preventing them from (re)appearing on your site or app. This is useful to make sure known copyrighted images, illegal images, or previously removed images do not get re-uploaded to your properties.

Once you add an image to the list, any near-duplicate image will be detected.

The steps to setup and use an Image Disallow List are the following:

  • Create an Image Disallow List from your dashboard.
  • Add Images to the disallow list (through the dashboard or through the API).
  • Check new and existing images against the disallow list.

To get more information on how to use Image Disallow Lists, check the documentation.

And send images to the feedback API

Our Image Moderation models have been trained to achieve best-in-class accuracy, yet you might want to report images you believe were misclassified. To do that, you can submit the image to the Feedback API.

Submitted images are used to improve the models on a continuous basis so your feedback is precious ! It can also be used to progressively train custom models adapted to your specific needs if you so wish.

To send an image to the Feedback API, you will need the image itself, the name of the model and the expected class (or the unknown label if the expected class is not available). Here are the available class:

ModelPossible classes
nuditysafe partial raw bikini chest cleavage lingerie unknown
nudity-2.0safe sexual_activity sexual_display erotica bikini male_chest cleavage lingerie miniskirt male_underwear miniskirt unknown
nudity-2.1safe sexual_activity sexual_display erotica bikini male_chest cleavage lingerie miniskirt male_underwear miniskirt unknown
goresafe gore unknown
gore-2.0safe gore unknown
typephoto illustration unknown
facenone single multiple unknown
wadno-weapons weapons no-alcohol alcohol no-drugs drugs unknown
weaponno-weapons weapons unknown
recreational_drugno-drugs drugs unknown
alcoholno-alcohol alcohol unknown
celebritiesno-celebrity celebrity unknown
textno-text text-artificial text-natural unknown
offensivenot-offensive offensive unknown
scamnot-scam scam unknown
minorno-minor minor unknown
gendermale female unknown
tobaccono-tobacco tobacco unknown
gamblingno-gambling gambling unknown
moneyno-money money unknown
text-contentsafe unsafe unknown
qr-contentsafe unsafe unknown
genaiai not-ai
unknownunknown miss safe

Sending a request to the Feedback API is very similar to requests sent to the Image Moderation API, see our documentation to get some code examples.

Please note that submitting an image to the Feedback API does not count as an operation and will not impact your billing.

Need more?

That said, if you believe you need more customization than provided out-of-the-box, for instance with new detection capacities or custom decision filters, please get in touch.

Was this page helpful?