检测提交接口

2025.02.17 14:08:42

    融媒体解决方案适用于多种类型媒体(文本、图片、点播音频、点播音视频、文档)合并过检场景,提交接口用于检测数据的提交。

    接口说明

    该接口为融媒体检测数据提交接口,建议使用HTTP协议进行接口调用。根据不同的检测数据类型,结果返回方式支持配置同步检测或异步检测:

    • 同步检测:支持文本和图片两种类型。配置同步检测会实时返回检测结果。
    • 异步检测:支持所有类型(文本、图片、音频、音视频和文档),其中音频、音视频和文档因为检测耗时相对较长,只支持异步检测。

    默认都是异步检测方式,如果需要设置同步检测,请联系易盾策略经理进行配置。

    鉴权说明

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

    检测数据要求

    请求体限制:所有请求参数大小总和不能超过10M

    文本要求

    文本限制:单次请求<5000字符,字段长度超过5000字符,会提示参数错误

    图片要求

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

    点播音频要求

    • 点播音频支持类型:URL
    • 点播音频支持格式:wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flac、alac、wavpack、silk_v3等
    • 点播音频大小:音频文件大小不超过550M
    • 点播音频时长:时长小于5小时

    点播音视频要求

    • 点播音视频支持类型:URL
    • 点播音视频支持格式:flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等
    • 点播音视频时长:时长小于5小时

    文档要求

    • 文档支持类型:URL
    • 文档支持格式:
      txt、doc、docx、ppt、pptx、xls、xlsx、xlsm、pdf、rar、zip、csv、rtf、odt、lrc、pot、potx、 pps、 ppsx、 pptm、 potm、 ppsm、 dot、 dotx、docm、dotm、xltm、xltx、xlt、et、ett、wps、wpt、dps、dpt、dwg、pst、vsd、vsdx、vsdm、xml、epub、ofd
    • 文档大小:单文档<150M

    检测耗时

    融媒体检测接口根据设置的同步或异步检测方式不同,接口耗时也不同,具体超时时间设置建议如下:

    异步检测: 此时接口只是接收提交的检测任务,检测流程异步进行,整体耗时较短,建议设置为200ms

    同步检测: 此时接口会执行同步检测流程,并同步返回检测结果

    • 文本同步检测,响应时间依赖文本的长度,根据不同长度建议适当调整接口超时时间,200字以内建议200ms,200字以上建议1s

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

    历史版本

    v1版本融媒体解决方案提交接口请点此查看

    请求

    名称
    HTTP URL https://as.dun.163.com/v2/mediasolution/submit
    HTTP Method POST

    请求头

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

    请求参数

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

    公共参数

    公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数

    业务参数

    名称 类型 是否必填 最大长度 描述
    version String 4 接口版本号,值为v2.1
    ip String 128 用户IP地址,建议抄送,辅助机审策略精准调优
    account 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,可选值-10000~10000
    censorExt String 1024 人审标签扩展字段,可传入任意标签内容,用于在人审模板(审核模板配置请参考人工审核模板高级配置)时指定数据并配置特殊审核逻辑。一次传入支持多个标签,标签间使用英文逗号","隔开,不支持大写英文字母,请全部使用小写
    publishTime Number 13 发表时间,UNIX 时间戳(毫秒值)
    dataId String 128 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
    title String 512 融媒体标题
    content Object[] 150000 content为json数组格式,提交时转换为string类型
     ∟ type String 10 类型,分别为text:文本,image:图片,audio:点播语音,audiovideo:音视频,file:文档
     ∟ data String 5000 检测数据,类型为text时最多传入20条文本内容,每条最长5000字符;类型为image时最多传入50张图url,每张最长512字符;类型为audio时最多传入5条语音url,每条最长512字符;类型为audiovideo时最多传入5条音视频url,每条最长512字符;类型为file时最多传入10个文url,每个最长512字符
     ∟ dataId String 128 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
     ∟ remark String 200 自定义备注信息
     ∟ config Obejct 128 检测数据配置
      ∟ scFrequency Number 4 截图检测频率,默认5秒截图检测一次,可设置范围为0.5~60秒
      ∟ subType Number 4 支持file内容提交,按照富文本样式展示,0:默认url提交,1:file按照内容提交,以富文本样式展示
      ∟ checkMode Number 4 指定检测模式,1:同步,2:异步;仅支持文本和图片数据,不传则以业务配置为准
      ∟ advancedFrequency String 128 高级截帧设置,此项填写,默认截帧策略失效,如{"durationPoints":[300,600],"frequencies":[1,5,10]}
       ∟ durationPoints Object[] 5 视频时长区间分割,单位为秒,数组最多5个
       ∟ frequencies Object[] 6 视频时长区间对应的截帧频率,可设置范围为0.5~600秒,数组最多6个
    自定义解析字段 Object[] 150000 格式同content字段。业务方自定义的解析检测或者解析不检测字段,支持同时设置多个自定义字段。确定字段名称、检测配置要求后,请联系易盾策略经理进行配置。注意:只要字段内容需要解析并展示在审核区域,就需要按此字段格式接入。
    自定义不解析字段 String 1024 业务自定义非解析检测字段,非解析检测字段无法切换为检测字段。确认字段名称、非检测配置后,请联系易盾策略经理进行配置。支持同时设置多个自定义不解析字段,字段内容将展示在扩展信息区域,辅助人工审核。
    callback String 512 数据回调参数,调用方根据业务情况自行设计,当调用融媒体异步检测获取结果时,该接口会原样返回该字段。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。
    callbackUrl String 1024 异步检测结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
    token String 256 内容安全与反作弊融合版专属字段,来自易盾反作弊SDK返回的token,接入SDK必传,请联系您的专属策略经理获取相关开发文档
    uniqueKey String 64 数据归档去重字段,开启归档去重功能的产品将根据此字段进行去重处理,配合dataVersion使用
    dataVersion Number 19 long型,值越大,代表版本越新,配合uniqueKey使用
    textCheckStrategyGroupIds String 512 针对融媒体文本类业务生效,业务指定过检策略组id, 多个策略组id以逗号分隔("xxx1","xxx2),最多支持传20个
    imageCheckStrategyGroupIds String 512 针对融媒体图片类业务生效,业务指定过检策略组id, 多个策略组id以逗号分隔("xxx1","xxx2),最多支持传20个
    audioCheckStrategyGroupIds String 512 针对融媒体音频类业务生效,业务指定过检策略组id, 多个策略组id以逗号分隔("xxx1","xxx2),最多支持传20个
    videoCheckStrategyGroupIds String 512 针对融媒体视频类业务生效,业务指定过检策略组id, 多个策略组id以逗号分隔("xxx1","xxx2),最多支持传20个

    请求体示例

    content=[{"type":"image","data":"https://url/image1.jpg","dataId":"01"},{"type":"text","data":"检测文本","dataId":"02"}]&version=v2.1&signature=signature&secretId=your_secret_id&timestamp=1646984669446&nonce=12353
    

    响应

    响应结果

    根据配置的同步检测和异步检测方式不同,响应结果也有一定的区别,响应公共字段已省略,详细见响应公共字段

    异步检测

    默认都是异步检测

    名称 类型 是否返回 描述
    result Object 融媒体结果
     ∟antispam Object 融媒体检测任务提交结果
      ∟ taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
      ∟ callback String 数据回调参数,请求参数中传来的callback字段原样返回

    同步结果返回

    在开启文本和图片同步结果返回的情况下,返回的结构如下:

    名称 类型 是否返回 描述
    result Object 融媒体结果
     ∟antispam Object 融媒体机器检测结果
      ∟ taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
      ∟ callback String 数据回调参数,请求参数中传来的callback字段原样返回
      ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
      ∟ resultType Number 结果类型,1:机器结果,2:人审结果
      ∟ checkStatus Number 检测状态,1:检测中,2:检测成功,3:检测失败
      ∟ evidences Object 机审证据信息, 默认只返回嫌疑和不通过的证据信息,以及检测失败数据的失败原因。由于图片存在下载失败等情况,请通过解析图片的failureReason确认检测失败原因。
       ∟ texts Object[] 文本检测结果
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
        ∟ field String 数据来源字段名。当数据来自提交接口的title或content时,此字段值为title或content,当数据来自提交接口自定义字段时,此字段值为自定义字段名
        ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
        ∟ resultType Number 结果类型,1:机器结果,2:人审结果
        ∟ censorType Number 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审
        ∟ strategyVersions Object[] 策略版本号,策略更新时该参数会更新,可用于追溯策略调优效果
         ∟ label Number 示例值:100,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观
         ∟ version String 版本号
        ∟ filteredContent String 过滤后文本内容,当命中信息中包含敏感词时,将敏感词内容用*代替后返回,*号数量与敏感词字数相同;若未命中敏感词,则不返回
        ∟ isRelatedHit Boolean 是否命中关联检测,true:关联检测命中,false:原文命中
        ∟ labels Object[] 命中的分类信息,检测通过情况labels默认返回为空
         ∟ label Number 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观
         ∟ level Number 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置
         ∟ subLabels Object[] 细分类信息,可能包含多个
          ∟ subLabel String 细分类,详细编码请参考下方对应细分类编码对照表
          ∟ subLabelDepth Number 命中的标签层级,目前支持的层级:2,3
          ∟ secondLabel String 命中二级标签细分类
          ∟ thirdLabel String 命中三级标签细分类
          ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
          ∟ details Object 命中的详细信息
           ∟ keywords Object[] 命中的敏感词信息
            ∟ word String 自定义敏感词内容
           ∟ libInfos Object[] 命中的自定义库信息
            ∟ type Number 库类型,1:自定义用户名单库,2:自定义ip名单库
            ∟ entity String 自定义用户名单信息,自定义ip名单信息
            ∟ releaseTime String 名单解封时间,时间戳单位毫秒
           ∟ hitInfos Object[] 命中的线索信息
            ∟ value String 线索内容
            ∟ positions Object[] 线索位置,数据起始位置为0,如果返回线索信息中包含emoij表情,一般emoij表情占2位
             ∟ fieldName String 位置类型,content:正文,title:标题
             ∟ startPos Number 线索开始坐标
             ∟ endPos Number 线索结束坐标
       ∟ images Object[] 图片检测结果
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
        ∟ field String 数据来源字段名。当数据来自提交接口的title或content时,此字段值为title或content,当数据来自提交接口自定义字段时,此字段值为自定义字段名
        ∟ name String 图片名称(或图片标识)
        ∟ status Number 检测状态:2 检测成功,3 检测失败
        ∟ failureReason Number 检测失败原因,当status为3(检测失败)时返回:610 图片下载失败、620 图片格式错误、630 其他
        ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
        ∟ resultType Number 结果类型,1:机器结果,2:人审结果
        ∟ frameSize Number 长图、gif图片拆帧后的分帧数,默认为1
        ∟ censorType Number 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审
        ∟ labels Object[] 命中的分类信息
         ∟ label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观
         ∟ level Number 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置
         ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为不通过或嫌疑,置信度越大,说明垃圾的可能性越高
         ∟ subLabels Object[] 细分类信息,可能包含多个
          ∟ subLabel String 细分类,详细编码请参考下方对应细分类编码对照表
          ∟ subLabelDepth Number 命中的标签层级,目前支持的层级:2,3
          ∟ secondLabel String 命中二级标签细分类
          ∟ thirdLabel String 命中三级标签细分类
          ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
          ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
          ∟ details Object 命中的详细对象信息
           ∟ keywords Object[] 命中的自定义敏感词信息
            ∟ word string 敏感词内容
            ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
            ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
            ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
            ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
           ∟ libInfos Object[] 命中的自定义图片名单信息
            ∟ type Number 1:自定义用户名单,2:自定义ip名单,3:自定义设备名单,4:自定义图片名单,目前只支持返回4自定义图片名单
            ∟ entity String 该图片命中自定义图片名单对应原始添加的根源图片url
            ∟ releaseTime Number 名单解封时间,时间戳单位毫秒
            ∟ hitCount String 历史针对该数据源图片命中所有次数
            ∟ value String 图片中包含的可识别内容
            ∟ group String value对应的分组名称,用于对value的解释
           ∟ hitInfos Object[] 命中的线索信息
            ∟ value String 图片中包含的可识别内容
            ∟ group String value对应的分组名称,用于对value的解释
            ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
            ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
            ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
            ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
     ∟valueAddService Object 增值服务信息,如有检测需求请联系易盾策略经理开启服务
      ∟ emotionAnalysis Object 情感分析检测结果
       ∟ texts Object[] 文本情感分析检测结果
        ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
        ∟ field String 数据来源字段名。当数据来自提交接口的title或content时,此字段值为title或content,当数据来自提交接口扩展字段时,此字段值为扩展字段名
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
        ∟ details Object[] 命中的详细信息
         ∟ positiveProb Number 正向情绪倾向,取值0-1,分数越高,正向情绪越高
         ∟ negativeProb Number 负向情绪倾向,取值0-1,分数越高,负向情绪越高
         ∟ sentiment String 情感类型,negative(负向情绪),neutral(中性情绪),positive(正向情绪),unknown(未知)
      ∟ language Object 语种检测结果
       ∟ texts Object[] 文本语种检测结果
        ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
        ∟ field String 数据来源字段名。当数据来自提交接口的title或content时,此字段值为title或content,当数据来自提交接口扩展字段时,此字段值为扩展字段名
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
        ∟ details Object[] 命中的详细信息
         ∟ type String 语种代码详见,语种代码表
      ∟ ocr Object OCR结果信息
       ∟ images Object[] 图片OCR结果信息
        ∟ taskId String 检测任务ID
        ∟ field 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 位置信息,对应目标矩形右下角纵坐标相对坐标
      ∟ face Object 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
       ∟ images Object[] 图片人脸检测信息
        ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
        ∟ field String 数据来源字段名
        ∟ 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)、海外娱乐明星(overseaEntertainmentStar)、海外体育明星(overseaSportStar)、海外政客(overseaPolitician)、海外网红(overseaInternetStar)
          ∟ beautyScore Number 人脸颜值分数,0-1,保留4位小数,如有检测需求请联系易盾策略经理开启服务,如有需要请联系您的专属商务,未开通状态下不返回该字段
          ∟ sizeRatio String 人脸占比,百分比形式
          ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
          ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
          ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
          ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
      ∟ quality Object 图片质量检测结果,图片质量检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
       ∟ images Object[] 图片质量检测结果
        ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
        ∟ field 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进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
       ∟ images Object[] 图片logo检测结果
        ∟ taskId String 检测任务ID
        ∟ field 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 图片识别结果,识别检测支持对图片中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此数组返回为空
       ∟ images Object[] 图片识别结果
        ∟ taskId String 检测任务ID
        ∟ field String 数据来源字段名
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询
        ∟ details Object[] 命中的详细信息
         ∟ discernName String 识别物体名称
         ∟ rate Number 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。
         ∟ type Number 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别,5:动漫识别,6:服饰识别,7:地图截图识别,8:聊天截屏识别,9:手机识别,10:举白纸识别,11:哺乳照识别,12:可爱卡通骷髅识别
     ∟anticheat Object 反作弊检测结果,如有检测需求请联系易盾策略经理开启服务
      ∟ taskId String 检测任务ID
      ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
      ∟ hitInfo Number 命中信息
       ∟ hitType Number 反作弊命中类型,详见hitType返回码及含义表

    响应示例

    异步结果返回示例

    {
        "code": 200,
        "msg": "ok",
        "result": {
            "antispam": {
                "dataId": "131246",
                "callback": "i am callback",
                "taskId": "jk5wux0l0u6zjmotwc088svg05009pgr"
            }
        }
    }
    

    同步结果返回示例

    文本和图片开启同步结果返回

    {
        "code":200,
        "msg":"ok",
        "result":{
            "antispam":{
                "checkStatus":2,
                "dataId":"131246",
                "suggestion":2,
                "callback":"i am callback",
                "evidences":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "suggestion":2,
                            "censorType":0,
                            "name":"81uoe1igu601b2v2wfoik3fg05009pgr",
                            "resultType":1,
                            "labels":[
                                {
                                    "subLabels":[
                                        {
                                            "subLabel":"50003",
                                            "rate":1,
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "y1":0.1756,
                                                        "y2":0.7165,
                                                        "x1":0.1711,
                                                        "x2":0.8457,
                                                        "value":"李四"
                                                    }
                                                ]
                                            }
                                        }
                                    ],
                                    "level":2,
                                    "rate":1,
                                    "label":500
                                },
                                {
                                    "level":0,
                                    "rate":1,
                                    "label":300
                                }
                            ],
                            "status":2
                        }
                    ],
                    "texts":[
                        {
                            "dataId":"192470",
                            "field":"image1",
                            "suggestion":2,
                            "censorType":0,
                            "isRelatedHit":false,
                            "resultType":1,
                            "labels":[
                                {
                                    "subLabels":[
                                        {
                                            "subLabel":"100080",
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "positions":[
                                                            {
                                                                "fieldName":"content",
                                                                "startPos":0,
                                                                "endPos":2
                                                            }
                                                        ],
                                                        "value":"测试"
                                                    },
                                                    {
                                                        "positions":[
                                                            {
                                                                "fieldName":"content",
                                                                "startPos":23,
                                                                "endPos":24
                                                            }
                                                        ],
                                                        "value":"江"
                                                    }
                                                ],
                                                "keywords":[
                                                    {
                                                        "word":"测试"
                                                    }
                                                ]
                                            }
                                        },
                                        {
                                            "subLabel":"100002"
                                        }
                                    ],
                                    "level":2,
                                    "label":100
                                },
                                {
                                    "subLabels":[
                                        {
                                            "subLabel":"500001",
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "positions":[
                                                            {
                                                                "fieldName":"content",
                                                                "startPos":15,
                                                                "endPos":18
                                                            }
                                                        ],
                                                        "value":"测试1"
                                                    }
                                                ]
                                            }
                                        },
                                        {
                                            "subLabel":"500013",
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "positions":[
                                                            {
                                                                "fieldName":"content",
                                                                "startPos":15,
                                                                "endPos":18
                                                            }
                                                        ],
                                                        "value":"测试2"
                                                    }
                                                ]
                                            }
                                        }
                                    ],
                                    "level":2,
                                    "label":500
                                },
                                {
                                    "level":0,
                                    "label":200
                                },
                                {
                                    "level":0,
                                    "label":260
                                }
                            ]
                        }
                    ]
                },
                "resultType":1,
                "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
            },
            "valueAddService":{
                "emotionAnalysis":{
                    "texts":[
                        {
                            "dataId":"192470",
                            "field":"image1",
                            "details":[
                                {
                                    "sentiment":"positive",
                                    "positiveProb":0.7576994299888611,
                                    "negativeProb":0.24208970367908478
                                }
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "face":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "details":[
                                {
                                    "faceContents":[
                                        {
                                            "maskType":"normal",
                                            "expression":"happy",
                                            "gender":"male",
                                            "y1":0.1756,
                                            "name":"张三",
                                            "y2":0.7165,
                                            "x1":0.1711,
                                            "x2":0.8457,
                                            "type":"normal",
                                            "category":"normal",
                                            "beautyScore":0.49,
                                            "age":50
                                        }
                                    ],
                                    "faceNumber":1
                                }
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "discern":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "details":[
                                {
                                    "rate":0.9593,
                                    "type":3,
                                    "discernName":"张三"
                                },
                                {
                                    "rate":0.755,
                                    "type":3,
                                    "discernName":"人物特写"
                                },
                                {
                                    "rate":0.4752,
                                    "type":3,
                                    "discernName":"人脸"
                                }
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "logo":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "details":[
    
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "language":{
                    "texts":[
                        {
                            "dataId":"192470",
                            "field":"image1",
                            "details":[
                                {
                                    "type":"zh"
                                }
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "quality":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "details":[
                                {
                                    "metaInfo":{
                                        "byteSize":124343,
                                        "format":"png",
                                        "width":267,
                                        "height":333
                                    },
                                    "sharpnessRate":0.7394,
                                    "aestheticsRate":0.6262,
                                    "boarderInfo":{
                                        "hit":false,
                                        "top":false,
                                        "left":false,
                                        "bottom":false,
                                        "right":false
                                    },
                                    "backgroundInfo":{
                                        "pureBackground":false
                                    }
                                }
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr"
                        }
                    ]
                },
                "ocr":{
                    "images":[
                        {
                            "dataId":"792707",
                            "field":"image1",
                            "width":267,
                            "details":[
    
                            ],
                            "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr",
                            "height":333
                        }
                    ]
                }
            },
            "anticheat":{
                "suggestion":2,
                "taskId":"81uoe1igu601b2v2wfoik3fg05009pgr",
                "hitInfo":{
                    "hitType":3
                }
            }
        }
    }
    

    响应返回码

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

    示例代码

    服务端 SDK 接入

    推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 了解更多。

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

    HTTP API 接入

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

    Online Chat Tel:95163223 Free trial