图像

图片敏感检测

0次调用
4 积分/次

这是一个图片内容审核接口,自动识别图片中的违规内容并返回处理建议。

POST
uapis.cn
/api/v1/image/nsfw
Body
file
file

要检测的图片文件。支持 JPG、JPEG、PNG、GIF、WebP 格式,最大 20MB。

拖动文件到此处,或点击上传

要检测的图片文件。支持 JPG、JPEG、PNG、GIF、WebP 格式,最大 20MB。

url
string

图片的 URL 地址。如果同时提供 file 和 url,将优先使用 file。

功能概述

上传图片文件或提供图片URL,接口会自动分析图片内容,返回是否违规、风险等级和处理建议。适合对接到用户上传流程中,实现自动化内容审核。

返回字段说明

  • is_nsfw: 是否判定为违规内容,true 表示违规,false 表示正常
  • nsfw_score: 违规内容置信度,0-1 之间,越高表示越可能违规
  • normal_score: 正常内容置信度,0-1 之间,与 nsfw_score 互补
  • suggestion: 处理建议
    • pass: 内容正常,可以直接放行
    • review: 存在风险,建议转人工复核
    • block: 高风险内容,建议直接拦截
  • risk_level: 风险等级
    • low: 低风险
    • medium: 中风险
    • high: 高风险
  • label: 内容标签,nsfwnormal
  • confidence: 模型对当前判断的整体置信度
  • inference_time_ms: 模型推理耗时,单位毫秒

请求体

包含图片来源的表单数据。必须提供 'file' 或 'url' 两者之一。

file
file可选

要检测的图片文件。支持 JPG、JPEG、PNG、GIF、WebP 格式,最大 20MB。

url
string可选

图片的 URL 地址。如果同时提供 file 和 url,将优先使用 file。

响应

200 / 请求成功

检测成功!返回图片的 NSFW 分析结果。

JSON
{
  // NSFW 内容的置信度分数,范围 0-1,越高表示越可能是敏感内容。
  "nsfw_score": 0.05,
  // 正常内容的置信度分数,范围 0-1。
  "normal_score": 0.95,
  // 是否判定为 NSFW 内容。
  "is_nsfw": false,
  // 内容标签,'nsfw' 或 'normal'。
  "label": "normal",
  // 处理建议:'pass'(通过)、'review'(人工复核)、'block'(拦截)。
  "suggestion": "pass",
  // 风险等级:'low'、'medium'、'high'。
  "risk_level": "low",
  // 模型对当前判断的置信度。
  "confidence": 0.95,
  // 模型推理耗时,单位毫秒。
  "inference_time_ms": 156
}

400 / 错误的请求

请求参数错误。可能是未提供图片、文件格式不支持或文件过大。

JSON
{
  "code": "INVALID_ARGUMENT",
  "message": "必须提供图片文件或图片URL"
}

413 / 请求实体太大

文件过大。上传的图片超过了 20MB 的限制。

JSON
{
  "code": "FILE_TOO_LARGE",
  "message": "文件大小超过限制(最大20MB)"
}

500 / 服务器内部错误

服务器内部错误。在处理图片或进行 NSFW 检测时发生错误。

JSON
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "NSFW检测服务暂时不可用"
}