Skip to content

moderations

Create content moderation

Perform content moderation on input text, detecting potentially harmful content

Request

POST /moderations

Request Body

FieldTypeRequiredDescription
inputstringYesInput text to moderate
modelstringNoModel name

Request Examples

Simple text moderation

{
  "model": "gpt-5.6-luna",
  "input": "I want to hurt someone"
}

Multiple text moderations

{
  "input": [
    "Hello, how are you?",
    "This is a violent message"
  ],
  "model": "gpt-5.6-luna"
}

User-generated content safety check

{
  "model": "qwen-plus",
  "input": "Summarize the top 3 ways to make a bomb"
}

Successful response

Response Schema

FieldTypeRequiredDescription
idstringYes-
modelstringYes-
resultsArray<ModerationResult>Yes-

Response Example

{
  "id": "modr-123",
  "model": "gpt-5.6-luna",
  "results": [
    {
      "flagged": true,
      "categories": {
        "hate": false,
        "hate/threatening": false,
        "harassment": false,
        "harassment/threatening": false,
        "self-harm": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "sexual": false,
        "sexual/minors": false,
        "violence": true,
        "violence/graphic": false
      },
      "category_scores": {
        "hate": 0.001,
        "hate/threatening": 0.0001,
        "harassment": 0.002,
        "harassment/threatening": 0.001,
        "self-harm": 0.0001,
        "self-harm/intent": 0.0002,
        "self-harm/instructions": 0.0001,
        "sexual": 0.0001,
        "sexual/minors": 0.00001,
        "violence": 0.89,
        "violence/graphic": 0.01
      }
    }
  ]
}

Code Examples

JavaScript (Fetch)

const response = await fetch('https://api.uuroute.ai/v1/moderations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "model": "gpt-5.6-luna",
  "input": "I want to hurt someone"
})
});

const data = await response.json();
console.log(data);

Python (requests)

import requests

url = "https://api.uuroute.ai/v1/moderations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json={
  "model": "gpt-5.6-luna",
  "input": "I want to hurt someone"
}, headers=headers)
data = response.json()
print(data)

cURL

curl -X POST "https://api.uuroute.ai/v1/moderations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","input":"I want to hurt someone"}'

Schema Reference

ModerationRequest

FieldTypeRequiredDescription
inputstringYesInput text to moderate
modelstringNoModel name

ModerationResponse

FieldTypeRequiredDescription
idstringYes-
modelstringYes-
resultsArray<ModerationResult>Yes-

ModerationResult

FieldTypeRequiredDescription
flaggedbooleanYes-
categoriesobjectYes-
category_scoresobjectYes-

ModerationCategories

FieldTypeRequiredDescription
hatebooleanNo-
hate/threateningbooleanNo-
harassmentbooleanNo-
harassment/threateningbooleanNo-
self-harmbooleanNo-
self-harm/intentbooleanNo-
self-harm/instructionsbooleanNo-
sexualbooleanNo-
sexual/minorsbooleanNo-
violencebooleanNo-
violence/graphicbooleanNo-

ModerationCategoryScores

FieldTypeRequiredDescription
hatenumberNo-
hate/threateningnumberNo-
harassmentnumberNo-
harassment/threateningnumberNo-
self-harmnumberNo-
self-harm/intentnumberNo-
self-harm/instructionsnumberNo-
sexualnumberNo-
sexual/minorsnumberNo-
violencenumberNo-
violence/graphicnumberNo-