Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-262861121.0 KB

Classify text, image, or mixed content for safety

post/v1/moderations

Request body

modelstring

Moderation model ID. Omit to use the default moderation model.

Example request

{
  "model": "moderation-model-id",
  "input": "Text to classify for safety."
}

Response

Moderation classification response

idstring required

Moderation request identifier

modelstring required

Moderation model used for classification

Example response

{
  "id": "modr_...",
  "model": "moderation-model-id",
  "results": [
    {
      "categories": {
        "category_name": false
      },
      "category_scores": {
        "category_name": 0.01
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 100,
    "total_tokens": 112
  }
}