提交图片异步检测任务进行图片审核后,调用本接口查询检测结果。

描述

业务接口/green/image/results

客户端定时轮询查询异步检测结果。建议您将查询间隔设置为30秒,最长不能超出1个小时,否则结果将会丢失。

关于scene与label参数

在提交检测任务时,您需要指定scenes场景参数;而在检测返回结果中,则包含了您指定的场景对应的label结果分类参数。

在图片审核中,scene与label的对应关系如下:
场景 描述 scene label
图片智能监黄 识别图片中的色情内容。 porn
  • normal:正常图片,无色情内容
  • sexy:性感图片
  • porn:色情图片
图片暴恐涉政识别 识别图片中的暴恐涉政内容。 terrorism
  • normal:正常图片
  • bloody:血腥
  • explosion:爆炸烟光
  • outfit:特殊装束
  • logo:特殊标识
  • weapon:武器
  • politics:涉政
  • others:其他
图片广告识别 识别图片中的广告信息。 ad
  • normal:正常图片,无广告
  • ad:含广告图片
图片二维码识别 识别图片中的二维码。 qrcode
  • normal:正常图片
  • qr:含二维码的图片
图片不良场景识别 识别直播或视频中出现的黑屏、黑边、昏暗画面,画中画,抽烟,打架等不良场景图片。 live
  • normal:正常图片
  • meaningless:无意义图片
  • PIP:画中画
  • smoking:吸烟
图片logo识别 识别图片中的logo信息,比如台标,商标等。 logo
  • normal:正常图片
  • TV:带有管控logo的图片

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON数组,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 要查询的taskId列表。最大长度不超过1,000。

返回参数

返回结果说明,参见返回结果

返回body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应的请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应的请求中的URL。
results 数组 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result
表 1. result
名称 类型 是否必需 描述
scene 字符串 图片检测场景,和调用请求中的场景对应。
label 字符串 检测结果的分类,与具体的scene对应。取值范围参考scene和label说明
suggestion 字符串 建议用户执行的操作,取值范围:
  • pass:图片正常,无需进行其余操作,或者未识别出目标对象
  • review:检测结果不确定,需要进行人工审核,或识别出目标对象
  • block:图片违规,建议执行进一步操作(如直接删除或做限制处理)
说明 qrcode场景中suggestion并非管控建议,仅用于区分图片中是否包含二维码。
rate 浮点数 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。
details JSON数组 如果对GIF图截帧,该字段会标识需要注意(状态为review/block)的截帧信息。每个元素是个JSON结构体,具体结构描述见detail
extras JSON对象 附加信息。该值可能会调整,建议您不要在业务上进行依赖。
logoData 字符串数组 识图片中含有logo时,返回识别出来的logo信息,具体结构描述见logoData
说明 仅适用于logo场景(scene)。
sfaceData 数组 图片中包含暴恐识涉政内容时,返回识别出来的暴恐涉政信息,具体结构描述见sfaceData
说明 仅适用于terrorism和sface场景。关于该参数在sface场景中的具体内容,请参考敏感人脸检测
表 2. detail
名称 类型 是否必需 描述
rate 浮点数 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。
url 字符串 截帧的URL地址。
表 3. logData
名称 类型 是否必需 描述
type 字符串 识别出的logo类型,取值为TV (台标)。
name 字符串 识别出的logo名称。
x 浮点数 以图片左上角为坐标原点,logo区域左上角到y轴距离。
y 浮点数 以图片左上角为坐标原点,logo区域左上角到x轴距离。
w 浮点数 logo区域宽度。
h 浮点数 logo区域高度。
表 4. sfaceData
名称 类型 是否必需 描述
x 浮点数 以图片左上角为坐标原点,人脸区域左上角到y轴距离。
y 浮点数 以图片左上角为坐标原点,人脸区域左上角到x轴距离。
w 浮点数 人脸区域宽度。
h 浮点数 人脸区域高度。
faces 数组 识别出的人脸信息,具体结构描述见face
表 5. face
名称 类型 是否必需 描述
name 字符串 相似人物的名称。
rate 浮点数 相似概率。
id 字符串 人脸Id。

示例

请求示例
["fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695"]
返回示例
{
  "code": 200, 
  "msg": "OK", 
  "requestId": "39D67E51-66CB-47DC-B70D-1226BE4E484F",
  "data": [
    {
      "code": 200, 
      "msg": "OK", 
      "taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
      "results": [
        {
          "rate": 100, 
          "scene": "porn", 
          "suggestion": "block", 
          "label": "porn"
        }
      ]
    }
  ]
}