同步检测

2021.12.06 14:19:47

    图片同步检测接口帮助您检测图片中的违规内容和多维度的辅助信息,提供包括智能鉴黄、暴恐、涉政、违禁、广告、恶心、涉价值观等违规内容识别能力,以及logo识别、OCR识别、人脸识别、图片质量等多维度辅助信息能力

    接口说明

    该接口同步返回图片检测结果,支持http协议接口调用

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权

    图片要求

    • 图片支持类型:URL、BASE64
    • 图片支持格式:PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、ICO、HEIC
    • 图片大小(适用于同步和异步检测): 单张<10M,像素建议不低于50px*50px,像素过低会影响识别效果
    • 图片下载:下载时间限制为5秒内,如果下载时间超过5秒,接口检测失败
    • 请求体限制:所有请求参数大小总和不能超过10M(BASE64参数较大),单次请求图片数不能超过32
    • 截帧说明:易盾自动将GIF图,长图(长宽比大于5的图片)截帧过检,最多5张,GIF图,长图均按照实际截图张数进行计费

    检测耗时

    图片检测接口的响应时间依赖图片的下载时间,请保证被检测图片所在的存储服务稳定可靠,建议适当调整接口超时时间,建议为10s

    历史版本

    v4版本同步检测接口文档请点此查看

    请求

    请求地址

    名称
    HTTP URL http://as.dun.163.com/v5/image/check
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String 固定值:"application/x-www-form-urlencoded"

    请求参数

    请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数

    业务参数

    名称 类型 必填 最大长度 描述
    images String 32张或10MB images为json数组,支持批量检测,为具体图片检测数据,数组长度不能超过32,大小不能超过10M
     ∟ name String 1024 图片名称(或图片标识), 该字段为回调信号字段,产品可以根据业务情况自行设计,如json结构、或者为图片url均可
     ∟ type Number 4 类型,分别为1:图片URL,2:图片BASE64值
     ∟ data String - 图片内容,如type=1,则该值为图片URL,如type=2,则该值为图片BASE64值。图片URL检测单次请求最多支持32张,图片BASE64值检测单次请求大小限制为最多10MB
     ∟ callbackUrl String 256 离线结果回调通知到客户的URL。主动回调数据接口超时时间默认设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
     ∟ dataId String 128 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
    version String 4 接口版本号,值为v5.1
    dataType Number 4 子数据类型,与易盾内容安全服务约定即可
    publishTime Number 13 发表时间,UNIX 时间戳(毫秒值)
    checkLabels String 512 业务过检分类,如果没有勾选分类提交返回参数错误,您可指定多个垃圾类别进行机器检测,多个垃圾类别以逗号分隔("100,200"),指定后业务配置过检分类即失效,过检分类列表:100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观
    ip String 128 用户IP地址,建议抄送,辅助机审策略精准调优
    account String 128 用户唯一标识,与易盾账号画像库匹配,建议抄送,辅助机审策略精准调优
    nickname String 128 用户昵称,建议抄送,辅助机审策略精准调优
    deviceId String 128 用户设备id,与易盾设备画像库匹配,明文请转大写传入;MD5加密请明文转大写后MD5计算,再转大写传入,建议抄送
    deviceType Number 4 用户设备id的类型,0:其他,10:IMEI,11:AndroidID,12:IDFA,13:IDFV,14:MAC ,20:IMEI_MD5,21:AndroidID_MD5,22:IDFA_MD5,23:IDFV_MD5,24:MAC_MD5
    token String N 256 内容安全与反作弊融合版专属字段,来自易盾反作弊SDK返回的token,接入SDK必传,接入流程请参考防刷版开发文档

    其他业务扩展参数,有助于通过业务维度辅助内容安全结果判定,请参见业务拓展参数

    请求体示例

    images=[{"name":"test","type":1,"data":"url","dataId":"dataId"}]&version=v5&signature=xxx&secretId=xxx&businessId=xxx
    

    响应

    响应结果

    响应字段如下,响应公共字段已省略,详细见响应公共字段

    名称 类型 必须返回 描述
    result Object[] 图片检测结果
     ∟ antispam Object 图片内容安全检测结果
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ status Number 检测状态:2 检测成功、3 检测失败
      ∟ failureReason Number 检测失败原因,当status为3(检测失败)时返回:610 图片下载失败、620 图片格式错误、630 其他
      ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
      ∟ resultType Number 结果类型,1:机器结果,2:人审结果
      ∟ labels Object[] 命中的分类信息
       ∟ label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观
       ∟ level Number 分类级别,0:正常,1:不确定,2:确定
       ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为不确定或确定,置信度越大,说明垃圾的可能性越高
       ∟ subLabels Object[] 细分类信息,可能包含多个
        ∟ subLabel String 细分类,详细编码请参考下方对应细分类编码 对照表
        ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
        ∟ details Object 命中的详细对象信息
         ∟ keywords Object[] 命中的自定义敏感词信息
          ∟ word string 敏感词内容
          ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
          ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
          ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
          ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
         ∟ libInfos Object[] 命中的自定义图片名单信息
          ∟ entity String 该图片命中自定义图片名单对应原始添加的根源图片url
          ∟ hitCount String 历史针对该数据源图片命中所有次数
          ∟ value String 图片中包含的可识别内容
          ∟ group String value对应的分组名称,用于对value的解释
         ∟ hitInfos Object[] 命中的线索信息
          ∟ value String 图片中包含的可识别内容
          ∟ group String value对应的分组名称,用于对value的解释
          ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
          ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
          ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
          ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
         ∟ anticheat Object 命中的反作弊信息
          ∟ hitType Number 反作弊命中类型,详见hitType返回码及含义表
     ∟ ocr Object OCR结果信息,OCR功能需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ height Number 图片高度,单位像素
      ∟ width Number 图片宽度,单位像素
      ∟ details Object[] 命中的详细信息
       ∟ content String 该图片中所有的文字信息集合
       ∟ lineContents Object[] OCR行信息
        ∟ lineContent String 每行的文字信息
        ∟ lang String 语种信息
        ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
        ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
        ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
        ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
        ∟ x3 Number 位置信息,对应目标矩形右下角横坐标相对坐标
        ∟ y3 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
        ∟ x4 Number 位置信息,对应目标矩形右下角横坐标相对坐标
        ∟ y4 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
     ∟ face Object 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ details Object[] 命中的详细信息
       ∟ faceNumber Number 该图片中包含的人脸个数
       ∟ faceContents Object[] 人脸详细信息
        ∟ name String 图片种出现的人脸名字,未识别则为空。该字段可识别明星、政治人物等人脸信息,用于落马官员/劣迹艺人检测,或明星头像/政治头像检测
        ∟ glasses String 人脸戴眼镜,normal(无眼镜)、 glasses(普通眼镜)、 sunglasses(墨镜)
        ∟ gender String 人脸性别,值为男(male)、女(female);不可识别则为空
        ∟ age Integer 人脸年龄,值为具体年龄(age);不可识别则为空
        ∟ type String 人脸类型,包含卡通脸(cartoon)、普通(normal)
        ∟ category String 人物分类,包含名人(star)、普通(normal)
        ∟maskType String mask(有遮挡),normal(无遮挡)。判断人脸是否有遮挡,可以用于判断用户是否佩戴口罩墨镜纱巾等综合性遮挡场景
        ∟expression String 人脸情绪:neutral(扮酷),happy(微笑),sad(悲伤),surprise(惊讶),fear(害怕),anger(生气),disgust(不喜欢)
        ∟ beautyScore Number 人脸颜值分数,保留4位小数,如有检测需求请联系易盾策略经理开启服务
        ∟ sizeRatio String 人脸占比,百分比形式
        ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
        ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
        ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
        ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
     ∟ quality Object 图片质量检测结果,图片质量检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ details Object[] 命中的详细信息
       ∟ aestheticsRate Number 美观度分数,0-1,分数越高美观度越高,建议0.5分以上可认为美观度较好,0.3分以下可认为美观度较差,具体视业务场景而定
       ∟ sharpnessRate Number 清晰度分数,0-1,分数越高清晰度越高,建议0.5分以上可认为清晰度较好,0.3分以下可认为清晰度较差,具体视业务场景而定
       ∟ metaInfo Object 图片基本信息
        ∟ byteSize Number 图片大小,单位byte
        ∟ format String 图片格式
        ∟ height Number 图片高度,单位像素
        ∟ width Number 图片宽度,单位像素
       ∟ boarderInfo Object 图片背景信息
        ∟ hit Boolean 图片是否包含边框(任一边包含边框均视为包含)ture:包含边框;false:不包含边框
        ∟ top Boolean 图片顶部是否包含边框,ture:包含边框;false:不包含边框
        ∟ right Boolean 图片右侧是否包含边框,ture:包含边框;false:不包含边框
        ∟ bottom Boolean 图片底部是否包含边框,ture:包含边框;false:不包含边框
        ∟ left Boolean 图片左侧是否包含边框,ture:包含边框;false:不包含边框
       ∟ backgroundInfo Object 图片背景信息
        ∟ pureBackground boolean 纯色背景检测,ture:背景纯色;false:背景复杂
     ∟ logo Object logo检测结果,logo检测支持对图片中包含的通识logo进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ details Object[] 命中的详细信息
       ∟ logoName String logo名字,不可识别则为空
       ∟ x1 Number logo位置信息,对应logo矩形左上角横坐标相对坐标
       ∟ y1 Number logo位置信息,对应logo矩形左上角纵坐标相对坐标
       ∟ x2 Number logo位置信息,对应logo矩形右下角横坐标相对坐标
       ∟ y2 Number logo位置信息,对应logo矩形右下角纵坐标相对坐标
     ∟ discern Object 图片识别结果,识别检测支持对图片中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ name String 图片名称(或图片标识)
      ∟ dataId String 数据唯一标识
      ∟ details Object[] 命中的详细信息
       ∟ discernName String 识别物体名称
       ∟ rate Number 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。
       ∟ type Number 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别
     ∟userRisk Object 文本用户画像检测结果
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ dataId String 数据ID
      ∟ account String 账号信息
      ∟ details Object[] 命中的详细信息
       ∟riskType String yin_liu_hei_chan(引流黑产),qi_zha_xian_yi(欺诈嫌疑),she_jiao_la_ren(社交拉人)
       ∟riskLevel Number 账号等级,0:低风险,1:中风险,2:高风险
       ∟riskScore String 风险分值:0-1

    响应体示例

    { 
        "code": 200, 
        "msg": "ok", 
        "result": [ 
            { 
                "antispam": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "status": 2, 
                    "suggestion": 2, 
                    "dataId": "dataId", 
                    "name": "name",
                    "resultType": 1, 
                    "labels": [ 
                        { 
                            "label": 500, 
                            "level": 2, 
                            "rate": 1.0, 
                            "subLabels": [ 
                                { 
                                    "subLabel": 50003, 
                                    "rate": 1.0, 
                                    "details": { 
                                        "keywords": [ 
                                            { 
                                                "word": "自定义敏感词",
                                                "x1": 0.0473, 
                                                "y1": 0.0362, 
                                                "x2": 0.1964, 
                                                "y2": 0.1530 
                                            } 
                                        ], 
                                        "libInfos": [ 
                                            { 
                                                "entity": "自定义图片名单url", 
                                                "hitCount": 3,
                                                "value": "可识别内容", 
                                                "group": "可识别内容分组"
                                            } 
                                        ], 
                                        "hitInfos": [ 
                                            {  
                                                "value": "可识别内容", 
                                                "group": "可识别内容分组", 
                                                "x1": 0.0473, 
                                                "y1": 0.0362, 
                                                "x2": 0.1964
                                            }
                                        ], 
                                        "anticheat": { 
                                            "hitType": 1
                                        } 
                                    } 
                                } 
                            ] 
                        }, 
                        { 
                            "label": 300, 
                            "level": 2, 
                            "rate": 1.0, 
                            "subLabels": [ 
                                { 
                                    "subLabel": 30003, 
                                    "rate": 1.0 
                                }, 
                                { 
                                    "subLabel": 30002, 
                                    "rate": 0.99499786 
                                } 
                            ] 
                        }, 
                        { 
                            "label": 400, 
                            "level": 2, 
                            "rate": 1.0, 
                            "subLabels": [ 
                                { 
                                    "subLabel": 40007, 
                                    "rate": 1.0 
                                }, 
                                { 
                                    "subLabel": 40003, 
                                    "rate": 0.984296 
                                } 
                            ] 
                        } 
                    ] 
                }, 
                "ocr": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "dataId": "dataId", 
                    "name": "name",
                    "height": 730, 
                    "width": 572, 
                    "details": [ 
                        { 
                            "content": "唐新唐人电视台NEWTANGDYNASTYTELEVISIONRFA", 
                            "lineContents": [ 
                                { 
                                    "lineContent": "唐", 
                                    "x1": 0.0473, 
                                    "y1": 0.0362, 
                                    "x2": 0.1964, 
                                    "y2": 0.1530,
    				"x3": 0.1964, 
                                    "y3": 0.1530,
    				"x4": 0.1964, 
                                    "y4": 0.1530
                                    "lang": "zh" 
                                } 
                            ] 
                        } 
                    ] 
                }, 
                "face": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "name": "0", 
                    "dataId": "dataId", 
                    "details": [ 
                        { 
                            "faceNumber": 3, 
                            "faceContents": [ 
                                { 
                                    "name": "艾力更·依明巴海", 
    				"glasses":"normal",
                                    "x1": 0.0473, 
                                    "y1": 0.0362, 
                                    "x2": 0.1964, 
                                    "y2": 0.1530, 
                                    "type": "normal", 
                                    "category": "normal", 
                                    "gender": "male", 
                                    "age": 59, 
                                    "sizeRatio": "1.74%" 
                                } 
                            ] 
                        } 
                    ] 
                }, 
                "quality": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "name": "name", 
                    "dataId": "dataId", 
                    "details": [ 
                        { 
                            "aestheticsRate": 0.466, 
                            "sharpnessRate": 0.511, 
                            "metaInfo": { 
                                "byteSize": 355357, 
                                "height": 730, 
                                "width": 572, 
                                "format": "png" 
                            }, 
                            "boarderInfo": { 
                                "hit": false, 
                                "top": false, 
                                "right": false, 
                                "bottom": false, 
                                "left": false 
                            }, 
                            "backgroundInfo": { 
                                "pureBackground": false 
                            } 
                        } 
                    ] 
                }, 
                "logo": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "name": "name", 
                    "dataId": "dataId", 
                    "details": [ 
                        { 
                            "logoName": "RFA", 
                            "x1": 0.5611, 
                            "y1": 0.7369, 
                            "x2": 0.8444, 
                            "y2": 0.9506 
                        } 
                    ] 
                }, 
                "discern": { 
                    "taskId": "cb047f822b444668ad90453fbd4d88f4", 
                    "name": "name", 
                    "dataId": "dataId", 
                    "details": [ 
                        { 
                            "type": 1, 
                            "discernName": "game", 
                            "rate": 0.5611 
                        } 
                    ] 
                }, 
                 "userRisk":{
                    "taskId":"hfy5g22yezojhvd8t8kb66qg00309r8q",
                    "name":"test",
                    "dataId":"dataIdvalue",
                    "account":"123456",
                    "details":[
                        {
                            "riskType":"qi_zha_xian_yi",
                            "riskLevel":1,
                            "riskScore":0.6
                        },
                        {
                            "riskType":"yin_liu_hei_chan",
                            "riskLevel":2,
                            "riskScore":0.4
                        }
                    ]
                }
            } 
        ] 
    }
    

    响应返回码

    响应返回码见:响应返回码

    Online Chat Tel:95163223