> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 内容审核

> POST /v1/moderations —— OpenAI 内容安全分类

对文本(或图片)按多个内容类别打分,返回每个类别的命中标志与得分。

## 请求

```bash theme={null}
curl https://openp.ai/v1/moderations \
  -H "Authorization: Bearer $OPENPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-moderation-latest",
    "input": "I want to hurt myself."
  }'
```

### 参数

| 字段      | 类型              |  必填 | 说明                                                     |
| ------- | --------------- | :-: | ------------------------------------------------------ |
| `model` | string          |     | `omni-moderation-latest`(推荐)或 `text-moderation-latest` |
| `input` | string \| array |  ✅  | 待检查的文本或多模态数组(omni 模型支持图片)                              |

## 响应

```json theme={null}
{
  "id": "modr-...",
  "model": "omni-moderation-latest",
  "results": [
    {
      "flagged": true,
      "categories": {
        "self-harm": true,
        "self-harm/intent": true,
        "violence": false,
        "sexual": false
      },
      "category_scores": {
        "self-harm": 0.94,
        "self-harm/intent": 0.91,
        "violence": 0.01
      }
    }
  ]
}
```

`flagged: true` 表示触发任意类别。

## 多模态(图片)输入

```json theme={null}
{
  "model": "omni-moderation-latest",
  "input": [
    {"type": "text", "text": "Look at this image"},
    {"type": "image_url", "image_url": {"url": "https://..."}}
  ]
}
```

## 类别

| 类别                       | 含义     |
| ------------------------ | ------ |
| `sexual`                 | 色情内容   |
| `sexual/minors`          | 涉及未成年人 |
| `harassment`             | 骚扰     |
| `harassment/threatening` | 威胁性骚扰  |
| `hate`                   | 仇恨     |
| `hate/threatening`       | 威胁性仇恨  |
| `illicit`                | 非法行为   |
| `illicit/violent`        | 暴力非法   |
| `self-harm`              | 自我伤害   |
| `self-harm/intent`       | 自伤意图   |
| `self-harm/instructions` | 自伤指导   |
| `violence`               | 暴力     |
| `violence/graphic`       | 血腥暴力   |

## 计费

OpenAI Moderation 接口由官方 **免费** 提供,OpenPAI 通常不收取费用(以控制台显示为准)。