Skip to main content
POST
/
v1
/
moderations
curl https://api.cometapi.com/v1/moderations \ -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $COMETAPI_KEY" \ -d '{ "model": "omni-moderation-latest", "input": "I want to bake cookies for my family." }' 
{
  "id": "modr-1594",
  "model": "omni-moderation-latest",
  "results": [
    {
      "flagged": false,
      "categories": {
        "harassment": false,
        "harassment/threatening": false,
        "hate": false,
        "hate/threatening": false,
        "illicit": false,
        "illicit/violent": false,
        "self-harm": false,
        "self-harm/intent": false,
        "self-harm/instructions": false,
        "sexual": false,
        "sexual/minors": false,
        "violence": false,
        "violence/graphic": false
      },
      "category_scores": {
        "harassment": 0.0001,
        "harassment/threatening": 0.0001,
        "hate": 0.0001,
        "hate/threatening": 0.0001,
        "illicit": 0.0001,
        "illicit/violent": 0.0001,
        "self-harm": 0.0001,
        "self-harm/intent": 0.0001,
        "self-harm/instructions": 0.0001,
        "sexual": 0.0001,
        "sexual/minors": 0.0001,
        "violence": 0.0001,
        "violence/graphic": 0.0001
      },
      "category_applied_input_types": {
        "harassment": [
          "text"
        ],
        "harassment/threatening": [
          "text"
        ],
        "hate": [
          "text"
        ],
        "hate/threatening": [
          "text"
        ],
        "illicit": [
          "text"
        ],
        "illicit/violent": [
          "text"
        ],
        "self-harm": [
          "text"
        ],
        "self-harm/intent": [
          "text"
        ],
        "self-harm/instructions": [
          "text"
        ],
        "sexual": [
          "text"
        ],
        "sexual/minors": [
          "text"
        ],
        "violence": [
          "text"
        ],
        "violence/graphic": [
          "text"
        ]
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 0,
    "total_tokens": 12,
    "input_tokens": 12,
    "output_tokens": 0,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    },
    "input_tokens_details": null,
    "claude_cache_creation_1_h_tokens": 0,
    "claude_cache_creation_5_m_tokens": 0
  }
}
Use this endpoint to check user-generated content before you send it to a model endpoint. Send an OpenAI-compatible moderation request with a model and an input value.
Use a CometAPI API key in the bearer header: Authorization: Bearer $COMETAPI_KEY.

​
Request body

FieldTypeRequiredDescription
inputstring or arrayYesThe content to check. Use a string for one text input, an array of strings for batch text checks, or OpenAI-style multimodal parts such as text plus image_url.
modelstringYesModeration model ID. Use omni-moderation-latest for text and image moderation unless you have a specific moderation model requirement.
For multimodal moderation, send OpenAI-style multimodal input with a model that supports it, such as omni-moderation-latest. Public image URLs must be downloadable by CometAPI servers. For a copyable image test, use a base64 data URL.

​
Request examples

Send a single text string when you only need to classify one text input: 
curl https://api.cometapi.com/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -d '{
    "model": "omni-moderation-latest",
    "input": "I want to bake cookies for my family."
  }'
Send an array of strings when you want to check multiple text inputs in one request: 
curl https://api.cometapi.com/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -d '{
    "model": "omni-moderation-latest",
    "input": [
      "I want to bake cookies.",
      "I want to kill someone."
    ]
  }'
Send text plus an image URL when your moderation input includes an image that CometAPI can download: 
curl https://api.cometapi.com/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -d '{
    "model": "omni-moderation-latest",
    "input": [
      { "type": "text", "text": "...text to classify goes here..." },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://www.gstatic.com/webp/gallery/1.png"
        }
      }
    ]
  }'
Use a base64 data URL when you need a self-contained image request: 
curl https://api.cometapi.com/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -d '{
    "model": "omni-moderation-latest",
    "input": [
      { "type": "text", "text": "...text to classify goes here..." },
      {
        "type": "image_url",
        "image_url": {
          "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAAAAAA6fptVAAAADElEQVR4nGP4//8/AAX+Av4N70a4AAAAAElFTkSuQmCC"
        }
      }
    ]
  }'

​
Response shape

The response includes id, model, results, and usage. Each item in results reports whether the matching input was flagged, category booleans, category scores, and input types applied to each category. For a batch text request, results contains one item per input string. Use usage for billing and monitoring fields.

Authorizations

​
Authorization
string
header
required

CometAPI API key used for model requests. Send it as Authorization: Bearer $COMETAPI_KEY.

Body

application/json
​
model
string
required

Required moderation model ID. Use omni-moderation-latest for text and image moderation unless you have a specific moderation model requirement.

Example:

"omni-moderation-latest"

​
input
required

Content to check. Use a string for one text input, an array of strings for batch text checks, or OpenAI-style multimodal parts such as text plus image_url when the selected model supports it.

Example:

"I want to check this text before sending it to a model."

Response

Moderation decisions and token usage.

​
id
string
required

Moderation request ID.

Example:

"modr-1594"

​
model
string
required

Model used for moderation.

Example:

"omni-moderation-latest"

​
results
object[]
required

Moderation decisions. For batch text input, this array contains one result per input string.

​
usage
object
required

Token usage for the moderation request. Additional provider accounting fields can be present.