모더레이션 생성 - CometAPI Documentation

POST

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
  }
}

모델 엔드포인트로 보내기 전에 이 엔드포인트를 사용해 사용자 생성 콘텐츠를 검사하세요. model과 input 값을 포함한 OpenAI 호환 모더레이션 요청을 전송합니다.

bearer 헤더에 CometAPI API 키를 사용하세요: Authorization: Bearer $COMETAPI_KEY.

요청 본문

Field	Type	Required	Description
`input`	string or array	Yes	검사할 콘텐츠입니다. 하나의 텍스트 입력에는 문자열을 사용하고, 일괄 텍스트 검사에는 문자열 배열을 사용하거나, 텍스트와 `image_url` 같은 OpenAI 스타일 멀티모달 파트를 사용할 수 있습니다.
`model`	string	Yes	모더레이션 model ID입니다. 특정 모더레이션 모델 요구 사항이 없다면 텍스트 및 이미지 모더레이션에는 `omni-moderation-latest`를 사용하세요.

멀티모달 모더레이션의 경우 omni-moderation-latest처럼 이를 지원하는 모델과 함께 OpenAI 스타일 멀티모달 입력을 전송하세요. 공개 이미지 URL은 CometAPI 서버에서 다운로드할 수 있어야 합니다. 복사 가능한 이미지 테스트에는 base64 데이터 URL을 사용하세요.

요청 예시

하나의 텍스트 입력만 분류하면 되는 경우 단일 텍스트 문자열을 전송하세요:

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."
  }'

하나의 요청에서 여러 텍스트 입력을 검사하려면 문자열 배열을 전송하세요:

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."
    ]
  }'

CometAPI가 다운로드할 수 있는 이미지가 모더레이션 입력에 포함된 경우 텍스트와 이미지 URL을 함께 전송하세요:

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"
        }
      }
    ]
  }'

자체 포함형 이미지 요청이 필요할 때는 base64 데이터 URL을 사용하세요:

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"
        }
      }
    ]
  }'

응답 형태

응답에는 id, model, results, usage가 포함됩니다. results의 각 항목은 해당 입력이 플래그되었는지 여부, 카테고리 불리언 값, 카테고리 점수, 그리고 각 카테고리에 적용된 입력 유형을 보고합니다. 일괄 텍스트 요청의 경우 results에는 입력 문자열마다 하나의 항목이 포함됩니다. 청구 및 모니터링 필드에는 usage를 사용하세요.

인증

Authorization

string

header

필수

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

본문

application/json

model

string

필수

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

예시:

"omni-moderation-latest"

input

필수

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.

예시:

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

응답

Moderation decisions and token usage.

string

필수

Moderation request ID.

예시:

"modr-1594"

model

string

필수

Model used for moderation.

예시:

"omni-moderation-latest"

results

object[]

필수

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

Show child attributes

usage

object

필수

Token usage for the moderation request.

Show child attributes

마지막 수정일 2026년 6월 23일

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
  }
}

​요청 본문

​요청 예시

​응답 형태

인증

본문

응답

요청 본문

요청 예시

응답 형태