Create Moderation

Classifies if text and/or image inputs are potentially harmful. Learn more in the moderation guide.

POST /v1/moderations

Create Moderation

cURL

curl --request POST \
  --url https://aihubmix.com/v1/moderations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "I want to kill them."
}
'

200

{
  "id": "<string>",
  "model": "<string>",
  "results": [
    {
      "flagged": true,
      "categories": {
        "hate": true,
        "hate/threatening": true,
        "harassment": true,
        "harassment/threatening": true,
        "illicit": true,
        "illicit/violent": true,
        "self-harm": true,
        "self-harm/intent": true,
        "self-harm/instructions": true,
        "sexual": true,
        "sexual/minors": true,
        "violence": true,
        "violence/graphic": true
      },
      "category_scores": {
        "hate": 123,
        "hate/threatening": 123,
        "harassment": 123,
        "harassment/threatening": 123,
        "illicit": 123,
        "illicit/violent": 123,
        "self-harm": 123,
        "self-harm/intent": 123,
        "self-harm/instructions": 123,
        "sexual": 123,
        "sexual/minors": 123,
        "violence": 123,
        "violence/graphic": 123
      },
      "category_applied_input_types": {
        "hate": [
          "text"
        ],
        "hate/threatening": [
          "text"
        ],
        "harassment": [
          "text"
        ],
        "harassment/threatening": [
          "text"
        ],
        "illicit": [
          "text"
        ],
        "illicit/violent": [
          "text"
        ],
        "self-harm": [],
        "self-harm/intent": [],
        "self-harm/instructions": [],
        "sexual": [],
        "sexual/minors": [
          "text"
        ],
        "violence": [],
        "violence/graphic": []
      }
    }
  ]
}

授权

Authorization · string · header · 必填

Gateway-issued API key, formatted as sk-gateway-xxxxxxxx. Used by OpenAI-shaped endpoints (/v1/chat/completions, etc.).

请求体

application/json

input · string string[] object[] · 默认值: "" · 必填

Input (or inputs) to classify. Can be a single string, an array of strings, or an array of multi-modal input objects similar to other models.

示例:

"I want to kill them."

model · string enum<string> · 默认值: omni-moderation-latest

The content moderation model you would like to use. Learn more in the moderation guide, and learn about available models here.

示例:

"omni-moderation-2024-09-26"

响应

200

application/json

OK

Represents if a given text input is potentially harmful.

id · string · 必填

The unique identifier for the moderation request.

model · string · 必填

The model used to generate the moderation results.

results · object[] · 必填

A list of moderation objects.

Show child attributes