​
Moderate Image

To moderate image, you can use the image.moderate method. This method takes in a image string and returns a Promise that resolves to a ImageModerationResponse object.

​
Image from URL

index.ts
const contentMod = new ContentMod({
  publicKey: "<YOUR_PUBLIC_KEY>",
  secretKey: "<YOUR_SECRET_KEY>",
});

// Simple image moderation with a link
const response = await contentMod.image.moderate(
  "https://example.com/image.jpg"
);

// Image moderation with additional metadata to be saved with the moderation request
const response2 = await contentMod.image.moderate(
  "https://example.com/image.jpg",
  {
    meta: {
      userId: "1234",
    },
  }
);

// Optionally you can pass in an webhook callback url if you want to be notified when the moderation request is completed
const response3 = await contentMod.image.moderate(
  "https://example.com/image.jpg",
  {
    meta: {
      userId: "1234",
    },
    callbackUrl: "https://example.com/webhook",
  }
);

​
Webhook Callback

If you pass in a webhook callback url, the response will only be an object with the id property.

​
Image from Base64 encoded string

index.ts
import { ContentMod } from "@contentmod/sdk";
import fs from "fs";
const contentMod = new ContentMod({
  publicKey: "<YOUR_PUBLIC_KEY>",
  secretKey: "<YOUR_SECRET_KEY>",
});

// Read file from disk
const img = fs.readFileSync("./pingu.jpeg");
// Convert to base64 encoded string
const base64 = img.toString("base64");
// Submit image moderation
const imgResponse = await contentMod.image.moderate(base64, {
  meta: {
    userId: "1234",
  },
});

​
Properties

​
image
string
required
Image to moderateExample: https://example.com/image.jpg
​
options
object
An object of options for the moderation request

​
Response

The ImageModerationResponse object contains the following properties:
​
id
string
required
The ID of the moderation request.Example: 27fbdc0b-b295-46ce-93f5-81b2fc08a381
​
isSafe
boolean
required
Whether the image is considered safe.Example: true
​
confidence
number
required
Confidence of the safety of the image from 1-100.Example: 90
​
sentiment
string
required
Sentiment of the image, either negative, neutral or positive.available sentiment values are:
  • negative
  • neutral (default)
  • positive
Example: positive
​
sentimentScore
number
required
Sentiment score from 1-100 (negative, neutral, positive).Example: 90
​
riskScores
object
required
Overall risk score from 1-100.Example: 90
​
topics
array
required
General topics the image depicts, lowercase and no punctuation.Example: ["politics", "sports"]
​
nsfwCategories
array
required
An array of the categories of the image. The available categories are:
  • adult_content
  • suggestive_imagery
  • strong_language
  • violence_gore
  • horror_disturbing
  • alcohol
  • tobacco
  • substance_use
  • gambling
  • dating_relationship
  • medical_procedures”
  • crude_humor
  • political_content
Example: [{"category": "sexual", "severity": 90}]
​
summary
object
required
Summary of the image.Example: {"profanity": true, "totalFlags": 1, "contentRating": "G", "language": "en"}
​
suggestedActions
object
required
Suggested actions for the image.Example: {"reject": true, "review": true}
​
request
object
required
The request object.Example: {"requestId": "27fbdc0b-b295-46ce-93f5-81b2fc08a381", "timestamp": "2023-04-05T12:00:00.000Z"}
​
meta
object
required
The metadata of the request object that the user provided.Example: {"userId": "12345"}
​
hash
string
required
The SHA-256 hash of the image. Used for content comparison purposes.Example: 93a08bd10cd367bf83f12ba6590fcaef2f8deec8a47ce4ce88a15c7dda325ffa