内容审核

POST /v1/moderations — 检查文本内容是否违反使用政策

POST/v1/moderations

检查文本是否违反内容使用政策,返回是否命中(flagged)及各分类的判定与置信分。可用于生成前拦截用户输入、生成后过滤模型输出。

鉴权:在请求头携带 Authorization: Bearer <令牌>,详见鉴权与令牌

请求参数

inputstring | array必填

待审核文本,单个字符串或字符串数组

modelstring

审核模型 ID,如 text-moderation-latest。缺省时平台按 text-moderation-stable 路由

请求示例

# <MODERATION_MODEL_ID> 例如 text-moderation-latest,需先在模型列表确认已开通
curl https://api.jimu.chat/v1/moderations \
  -H "Authorization: Bearer $JIMU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<MODERATION_MODEL_ID>", "input": "待审核的文本"}'

响应结构

以下样例依据服务端响应结构定义给出,字段以实际返回为准:

响应200
{
  "id": "modr-...",
  "model": "<MODERATION_MODEL_ID>",
  "results": [
    {
      "flagged": false,
      "categories": { "harassment": false, "violence": false, "sexual": false, "...": false },
      "category_scores": { "harassment": 0.001, "violence": 0.002, "sexual": 0.001, "...": 0 }
    }
  ]
}
  • results 与输入一一对应。flaggedtrue 表示命中任一分类。
  • categories 为各分类的布尔判定,category_scores 为 0–1 的置信分。分类键集合取决于所用审核模型,上面仅为示意,以实际返回为准。
  • 批量传入数组时返回多条 results,按顺序对齐。
审核接口消耗积分,可用模型见模型能力本端点可用;模型需在你的账号下已开通,未开通返回 model_not_found