---
title: "Moderations"
method: POST
path: "/v1/moderations"
---

# Moderations

`POST /v1/moderations`

Classify text or multimodal inputs with OpenAI moderation.

## Request body

- object
  - `input` union, required — Plain text, an array of text strings, or an array of multimodal input items.
    - string — Plain text input to classify.
    - string[]
    - object[]
      - `type` 'text' | 'image_url', required — Input item type.
      - `text` string — Text content for `type: text` items.
      - `image_url` object — Image payload for `type: image_url` items.
        - `url` string, required — Image URL or data URL for `type: image_url` items.
  - `model` string — OpenAI moderation model. Defaults to omni-moderation-latest.

## Response `200`

Moderation response.

- object — Moderation response payload.
  - `id` string — Moderation response ID.
  - `model` string — Moderation model used for the request.
  - `results` object[] — Moderation results for the submitted input.
    - `flagged` boolean, required — Whether the input was flagged.
    - `categories` object — Category flags returned by the moderation model.
    - `category_scores` object — Model confidence scores for each category.
    - `category_applied_input_types` object — Input types that contributed to each category decision.

## Other responses

- `400` — Invalid request body or parameters.
- `401` — Unauthorized request.
- `402` — Payment required / insufficient credits.
- `403` — Forbidden upstream response.
- `404` — Not found upstream response.
- `410` — Archived or unavailable project.
- `429` — Rate limited upstream response.
- `500` — Internal server error.
- `502` — Failed to connect to the upstream provider.
- `503` — Service unavailable upstream response.
- `504` — Upstream provider timeout.

---

[API](https://skmtc.dev/llmgateway/apis/llmgateway-api.md) · [All operations](https://skmtc.dev/llmgateway/apis/llmgateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmgateway/llmgateway-api/revisions/aaf167e3d8cc/schema)