Skip to main content

Moderate Text

To moderate text, you can use the text.moderate method. This method takes in a text string and returns a Promise that resolves to a TextModerationResponse object.
index.ts

Webhook Callback

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

Properties

string
required
Text to moderateExample: Some bad text
object
An object of options for the moderation request

Response

The TextModerationResponse object contains the following properties:
string
required
The ID of the moderation request.Example: 27fbdc0b-b295-46ce-93f5-81b2fc08a381
boolean
required
Whether the text is considered safe.Example: true
number
required
Confidence of the safety of the text from 1-100.Example: 90
string
required
Sentiment of the text, either negative, neutral or positive.available sentiment values are:
  • negative
  • neutral (default)
  • positive
Example: positive
number
required
Sentiment score from 1-100 (negative, neutral, positive).Example: 90
object
required
Overall risk score from 1-100.Example: 90
array
required
General topics the text depicts, lowercase and no punctuation.Example: ["politics", "sports"]
array
required
An array of the categories of the text. 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}]
object
required
Summary of the text.Example: {"profanity": true, "totalFlags": 1, "contentRating": "G", "language": "en"}
object
required
Suggested actions for the text.Example: {"reject": true, "review": true}
string
required
The original text.Example: This is the original text
string
required
The text with profanity replaced by *.Example: This is a filtered text
object
required
The request object.Example: {"requestId": "27fbdc0b-b295-46ce-93f5-81b2fc08a381", "timestamp": "2023-04-05T12:00:00.000Z"}
object
required
The metadata of the request object that the user provided.Example: {"userId": "12345"}
string
required
The SHA-256 hash of the text. Used for content comparison purposes. Example: 93a08bd10cd367bf83f12ba6590fcaef2f8deec8a47ce4ce88a15c7dda325ffa