同步单条检测

接口概览

POSThttps://isafe.ilivedata.com/api/v2/image/check

图片要求
图片支持类型：URL, BASE64
图片支持格式：jpg, png, bmp, gif, webp, tiff, heic, avif
图片大小：单张 < 10M
gif 图、长图说明：自动将 gif 图、长图（长宽比大于 5 的图片）截帧过检，最多 5 张，gif 图、长图均按照实际截图张数进行计费

请求参数

请求头

Header	值	描述
`Content-Type`	application/json;charset=UTF-8	请求体类型
`Accept`	application/json;charset=UTF-8	接受的返回类型
`X-AppId`	—	项目的唯一标识，此值是「控制台 → 服务配置」中的项目编号
`X-TimeStamp`	—	请求发起时的 UTC 时间，采用 W3C 格式。格式示例：`2026-09-30T02:30:00Z`，实际请求需使用当前时间。
`Authorization`	—	签名值

请求体

参数	类型	是否必需	描述
`type`	Number	必需	图片内容类型：1：图片 URL；2：图片 BASE64 值。注：如果图片资源和请求审核的服务不在同一区域，推荐使用 BASE64 方式调用，图片 URL 在网络不佳时可能会造成图片下载缓慢或下载失败等问题
`image`	String	必需	图片内容。type=1 时为图片 URL；type=2 时为图片 BASE64 值。
`strategyId`	String	可选	策略编号；不传时使用默认策略 DEFAULT
`checkTags`	List<Number>	可选	限定检测类别。支持传入策略中开启的一级类别，当传入的某一类别在策略配置中未开启时，忽略该类别
`referImage`	String	可选	用来做人脸对比的参照图，图片类型需要和 image 一致（image 为 URL 则 referImage 也为 URL）。支持格式：jpg, png；大小 < 10M
`userId`	String	可选	唯一的终端用户 ID，不超过 32 个字符
`extra`	Object	可选	扩展透传字段，可传多个 key/value。例如：`"extra": {"server": "123", "version": "456"}`。不得超过 20 个 key/value，单个 key 不得嵌套超过 3 层；若超出限制，后台审核日志将不会记录本次任务的 extra 值，但不影响 extra 透传响应

请求示例

{
  "type": 1,
  "image": "http://abc.com/a.jpg",
  "strategyId": "DEFAULT",
  "userId": "testUser",
  "checkTags": [100, 200],
  "extra": { "server": "123", "version": "456" }
}

请求签名

签名计算规则见帮助中心的请求签名。本接口使用以下参数：

签名参数	值
`HTTPMethod`	`POST`
`HostHeaderInLowercase`	`isafe.ilivedata.com`
`HTTPRequestURI`	`/api/v2/image/check`

HTTP 响应

Content-Type: application/json;charset=UTF-8

结果为 JSON 格式。

响应字段

参数	类型	描述
`errorCode`	Number	错误码：0 表示成功；100001：图片下载失败；100002：图片格式错误
`errorMessage`	String	错误消息
`result`	Number	审核结论：0：通过；1：建议审核；2：不通过
`taskId`	String	任务 ID
`mediaType`	String	图片类型，例如：image/jpeg、image/png、image/gif、image/webp、image/bmp、image/heic、image/avif
`imageSize`	Number	图片大小，单位 byte
`snapshotUrl`	String	本次审核产生的图片快照地址
`imageSpams`	Object	违规检出明细，见下方 imageSpams（未检出违规信息时，将不返回该字段）
`ocr`	Object	识别文本内容，见下方 ocr（默认不返回该字段，需在控制台开启开关时返回）
`personInfo`	Object	人体/人脸/性别检测结果，见下方 personInfo
`labels`	Array	标签信息，见下方 labels
`extra`	Object	请求中透传的扩展字段

imageSpams

参数	类型	描述
`tags`	Array	命中的分类信息列表，见下方 tags

参数	类型	描述
`tag`	Number	一级分类代码，见检测类别。
`level`	Number	分类级别：0：正常；1：疑似；2：异常
`confidence`	Number	置信度分数，0-100。100 为置信度最高。若 level 为疑似或异常，置信度越大说明命中的可能性越高
`nameZh`	String	一级类型名称（中文）
`nameEn`	String	一级类型名称（英文）
`wordList`	List<String>	命中图文时返回违规文本（tag=400）
`subTags`	Array	二级分类信息，见下方 subTags

检测类别

代码	类别
`100`	涉政
`110`	暴恐
`120`	违禁
`130`	色情
`140`	性感
`150`	广告
`160`	涉价值观
`180`	未成年保护
`200`	二维码
`230`	无人脸挂机
`232`	图片质量
`300`	图标
`400`	图文
`666`	恶心
`800`	标签
`888`	人脸对比
`900`	其他
`999`	用户自定义

subTags

字段路径：imageSpams.tags[].subTags[]

参数	类型	描述
`subTag`	Number	二级分类编码，详细编码请参考分类编码对照表
`level`	Number	分类级别：0：正常；1：疑似；2：异常
`confidence`	Number	置信度分数，0-100
`nameZh`	String	二级类型名称（中文）
`nameEn`	String	二级类型名称（英文）
`wordList`	List<String>	命中图文时返回违规文本（tag=400）
`terTags`	Array	三级分类信息，见下方 terTags（需在控制台开启三级标签开关时返回）

terTags

字段路径：imageSpams.tags[].subTags[].terTags[]

参数	类型	描述
`terTag`	Number	三级分类编码
`level`	Number	分类级别：0：正常；1：疑似；2：异常
`confidence`	Number	置信度分数，0-100
`nameZh`	String	三级类型名称（中文）
`nameEn`	String	三级类型名称（英文）
`wordList`	List<String>	命中图文时返回违规文本（tag=400）

ocr

参数	类型	描述
`text`	List<String>	OCR 识别出的文本内容列表

personInfo

参数	类型	描述
`genders`	Array	人脸性别及其置信度，见下方 genders
`human`	Object	人体个数结果，示例：`{"number": 12}`
`face`	Object	人脸个数结果，示例：`{"number": 7}`

genders

字段路径：personInfo.genders[]

参数	类型	描述
`gender`	String	性别：male / female
`confidence`	Number	性别置信度，0-100

labels

参数	类型	描述
`id`	String	标签唯一标识
`score`	Number	模型得分，分值越高置信度越高
`nameZh`	String	标签名称（中文）
`nameEn`	String	标签名称（英文）

响应示例

{
  "errorCode": 0,
  "result": 2,
  "taskId": "ap_634e686ef7e54447af7463f4dd060d6d_1783514588456",
  "mediaType": "image/jpeg",
  "imageSize": 102400,
  "snapshotUrl": "https://cos.example.com/path/to/dumped-image.jpg",
  "imageSpams": {
    "tags": [
      {
        "tag": 100,
        "level": 2,
        "confidence": 90,
        "nameZh": "涉政",
        "nameEn": "politics",
        "subTags": [
          {
            "subTag": 100001,
            "level": 2,
            "confidence": 90,
            "nameZh": "政治人物",
            "nameEn": "political_figure",
            "terTags": [
              {
                "terTag": 100001001,
                "level": 2,
                "confidence": 90,
                "nameZh": "具体政治人物",
                "nameEn": "specific_political_figure"
              }
            ]
          }
        ]
      }
    ]
  },
  "ocr": {
    "text": [
      "苗华",
      "赵四"
    ]
  },
  "personInfo": {
    "genders": [
      {
        "gender": "male",
        "confidence": 90
      }
    ],
    "human": {
      "number": 12
    },
    "face": {
      "number": 7
    }
  },
  "labels": [
    {
      "id": "800001007",
      "score": 31,
      "nameZh": "人脸数",
      "nameEn": "face_num"
    }
  ],
  "extra": {}
}

错误码

详见帮助中心的通用错误码