推送模式

2024.01.30 15:44:15

    内容安全点播音视频结果获取推送模式用于将点播音视频异步检测或人工审核结果主动推送给客户,保证客户最快的获取结果。客户需要按照以下规范实现接收结果的接口。推送模式与轮询模式互斥,只能选取一种模式进行结果获取。

    接口说明

    结果主动推送模式以数据为维度,将异步机器检测结果或者人工审核结果推送给客户,需客户在调用检测接口时设置回调地址callbackUrl参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据。

    鉴权说明

    客户接口可以通过业务开通时易盾分配的密钥信息字段进行接口鉴权,鉴权粒度是否要精确到业务级别,用户可以根据需要自行决定,请参见接口鉴权

    接入说明

    • 协议说明:检测接口请求参数中指定了回调地址参数callbackUrl(即一个http(s)协议接口的URL)。主动推送接口需要支持http协议,支持POST方法,传输数据编码采用utf-8
    • 接口性能:推送结果接口默认超时时间为2s,为了保证顺利接收数据,客户需保证接收接口可用性和性能稳定
    • 失败重试:客户接口处理结果数据,并返回应答。如果客户接口请求异常,超时或收到的应答不符合规范,易盾会认为推送失败;我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送
    • 幂等性:结果推送时同样的结果可能会多次请求客户接口。客户接口需要保证幂等性,能够正确处理重复结果数据

    接口耗时

    客户接收接口需保证接收接口可用性和性能稳定,易盾请求超时时间为2s,客户接口尽量保证在1s内返回应答,如有特殊要求,可联系易盾运营适当调整超时时间

    请求

    请求地址

    名称
    HTTP URL 回调地址callbackUrl
    HTTP Method POST

    请求头

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

    请求参数

    名称 类型 必填 最大长度 描述
    secretId String 32 产品秘钥 id ,由易盾内容安全云服务分配,产品标识
    signature String 32 请求签名,用来验证此次请求的合法性,具体算法见接口鉴权
    callbackData String - 主动推送结果数据,格式为 json 字符串, 详细见下表 callbackData 结构
    名称 类型 必须返回 描述
    callbackData String 音频检测结果
     ∟ antispam Object 内容安全检测结果
      ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ status Number 检测状态,2:检测成功,3:检测失败
      ∟ suggestion Number 建议结果 0:通过,1:嫌疑,2:删除
      ∟ label Number 整体垃圾分类,0:正常,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,800:恶心类,900:其他,1020:黑屏,1030:挂机,1050:噪音,1100:涉价值观
      ∟ resultType Number 结果类型 1:机器结果,2:人审结果
      ∟ callback String 提交时传递的callback
      ∟ censorSource Number 审核来源,0:易盾人审,1:客户人审,2:易盾机审,3:用户质检,4:易盾质检
      ∟ censorTime Number 人工审核完成时间,毫秒单位时间戳(13位)
      ∟ checkTime Number 机器审核完成时间,毫秒单位时间戳(13位)
      ∟ duration Number 音视频开始到结束的总时长,单位毫秒
      ∟ picCount Number 视频截图张数
      ∟ solutionExtra Object 子数据检测失败原因汇总,检测失败或部分检测失败会返回,检测成功不返回
       ∟ failedUnit Object 子数据检测失败原因汇总
        ∟ audio Object 音频检测失败原因
         ∟ failureReason Number 音频:1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在。
        ∟ video Object 视频检测失败原因
         ∟ failureReason Number 视频:110:请求重复,120:参数错误,130:解析错误,140:数据类型错误,160:视频大小超限(>5G)。
        ∟ images Object[] 图片检测失败原因
         ∟ failureReason Number 图片:610:图片下载失败,620:图片格式错误,630:其他。
         ∟ name String 图片名称(或图片标识)
      ∟ evidences Object 证据信息 包含 text文本,image截图, audio音频,video视频属性
       ∟ text Object 文本检测信息
        ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
        ∟ suggestion Number 建议结果 0:通过,1:嫌疑,2:删除
        ∟ resultType Number 结果类型 1:机器结果,2:人审结果
        ∟ censorType Number 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审
        ∟ isRelatedHit Boolean 是否关联检测命中,true:关联检测命中,false:原文命中
        ∟ labels Object[] 命中的分类信息
         ∟ label Number 命中分类,示例值:100
         ∟ level Number 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置
         ∟ subLabels Object[] 细分类信息,可能包含多个
          ∟ subLabel String 细分类,详细编码请参考下方对应细分类编码 对照表
          ∟ subLabelDepth Number 命中的标签层级,目前支持的层级:2,3
          ∟ secondLabel String 命中二级标签细分类
          ∟ thirdLabel String 命中三级标签细分类
          ∟ details Object 命中的详细信息
           ∟ keywords Object[] 命中的敏感词信息
            ∟ word String 敏感词内容
           ∟ libInfos Object[] 命中的自定义库信息
            ∟ type Number
            ∟ entity String 自定义库实体
           ∟ hintInfos Object[] 命中的线索信息
            ∟ value String 线索内容
            ∟ positions Object[] 线索位置
             ∟ fieldName String 返回title(音视频标题),content(音视频简介)
             ∟ startPos Number 线索开始坐标
             ∟ endPos Number 线索结束坐标
           ∟ rules Object[] 命中用户自定义的规则信息
            ∟ name String 规则名
       ∟ images Object[] 图片检测结果
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
        ∟ name String 图片名称(或图片标识)
        ∟ status Number 检测状态:2 检测成功、3 检测失败
        ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
        ∟ resultType Number 结果类型,1:机器结果,2:人审结果
        ∟ labels Object[] 命中的分类信息
         ∟ label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1020:黑屏,1030:挂机,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 命中三级标签细分类
          ∟ hitStrategy Number 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字
          ∟ 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 Number 历史针对该数据源图片命中所有次数
            ∟ value String 图片中包含的可识别内容
            ∟ group String value对应的分组名称,用于对value的解释
           ∟ hintInfos Object[] 命中的线索信息
            ∟ value String 图片中包含的可识别内容
            ∟ group String value对应的分组名称,用于对value的解释
            ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
            ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
            ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
            ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
           ∟ rules Object[] 命中用户自定义的规则信息
            ∟ name String 规则名
       ∟ audio Object 音频检测结果
        ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
        ∟ status Number 检测状态,2-检测成功,3-检测失败
        ∟ label Number 音频整体分类信息,0:正常,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观
        ∟ failureReason Number 检测失败原因,当检测失败时返回,1:文件格式错误,2:文件下载失败,3:解析失败,4:音频流不存在
        ∟ suggestion Number 建议结果 0-通过 1-嫌疑 2-删除
        ∟ resultType Number 结果类型 1-机器结果 2-人审结果
        ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
        ∟ callback String 提交时传递的callback
        ∟ censorSource Number 审核来源,0:易盾人审,1:客户人审,2:易盾机审
        ∟ censorTime Number 审核完成时间,毫秒单位时间戳(13位)
        ∟ duration Number 音频时长字段,单位s
        ∟ durationMs Number 音频时长字段,单位ms
        ∟ customAction Number 客户自定义建议结果 0-通过 2-删除
        ∟ segments Object[] 音频数据所在断句详细信息
         ∟ startTime Number 断句开始时间点,单位秒
         ∟ endTime Number 断句结束时间点,单位秒
         ∟ startTimeMillis Number 断句开始时间点,单位毫秒
         ∟ endTimeMillis Number 断句结束时间点,单位毫秒
         ∟ type Number 断句类型,0-语音识别,1-声纹检测
         ∟ leaderName String 领导人名,若命中领导人声纹,返回对应的领导人名
         ∟ url String 风险片段对应语音片段的临时访问地址,地址有效期为7天,如需开启请联系易盾策略经理
         ∟ content String 音频数据所在断句语音识别原文内容,支持返回异常数据所在断句内容
         ∟ labels Object[] 分类信息
          ∟ label Number 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观
          ∟ level Number 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置
          ∟ subLabels Object[] 命中细分类信息
           ∟ subLabel String 细分类,详细编码请参考细分类编码 对照表
           ∟ subLabelDepth Number 命中的标签层级,目前支持的层级:2,3
           ∟ secondLabel String 命中二级标签细分类
           ∟ thirdLabel String 命中三级标签细分类
           ∟ details Object 其他信息
            ∟ hitInfos Object[] 证据信息
             ∟ value String 命中的敏感词或者声纹检测的分值
             ∟ songName String 命中的涉政歌曲名称
            ∟ keywords Object[] 自定义敏感词线索分类信息
             ∟ word String 自定义添加敏感词
            ∟ libInfos Object[] 自定义名单线索分类信息
             ∟ listType Number 名单类型
             ∟ entity String 名单内容
            ∟ rules Object[] 命中用户自定义的规则信息
             ∟ name String 规则名
       ∟ video Object 视频检测结果
        ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
        ∟ status Number 检测状态,2:检测成功,3:检测失败
        ∟ failureReason Number 检测失败原因,当检测失败时返回,110:请求重复,120:参数错误,130:解析错误,140:数据类型错误,160:视频大小超限(>5G)
        ∟ suggestion Number 建议结果 0:通过,1:嫌疑,2:删除
        ∟ resultType Number 结果类型 1:机器结果,2:人审结果
        ∟ callback String 提交时传递的callback
        ∟ censorSource Number 审核来源,0:易盾人审,1:客户人审,2:易盾机审
        ∟ censorTime Number 人工审核完成时间,毫秒单位时间戳(13位)
        ∟ duration Number 视频时长字段,单位s
        ∟ customAction Number 客户自定义建议结果 0-通过 2-删除
        ∟ censorLabels String[] 支持在智能审核系统自定义标签分类信息
        ∟ picCount Number 截图张数
        ∟ pictures Object[] 截图证据信息
         ∟ type Number 截图类型,1:图片,2:视频
         ∟ url String 截图下载地址
         ∟ startTime Number 证据开始相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29"
         ∟ endTime Number 证据结束相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29"
         ∟ pictureId String 截图id
         ∟ frontPics Object[] 关联信息-命中前截图信息
          ∟ url String 命中前截图下载地址
         ∟ backPics Object[] 关联信息-命中后截图信息
          ∟ url String 命中前截图下载地址
         ∟ 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 命中三级标签细分类
           ∟ hitStrategy Number 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字
           ∟ 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 Number 历史针对该数据源图片命中所有次数
             ∟ value String 图片中包含的可识别内容
             ∟ group String value对应的分组名称,用于对value的解释
            ∟ hintInfos Object[] 命中的线索信息
             ∟ value String 图片中包含的可识别内容
             ∟ group String value对应的分组名称,用于对value的解释
             ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
             ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
             ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
             ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
            ∟ rules Object[] 命中用户自定义的规则信息
             ∟ name String 规则名
      ∟ reviewEvidences Object 此字段只有人审核之后才会有值,人审证据信息 包含 text文本,image截图, audio音频,video视频属性
       ∟ spamType Number 人审垃圾类型,100:色情,110:性感低俗,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:漫骂,700:灌水,900:其他,1100:涉价值观
       ∟ description String 描述
       ∟ detail String 详情
       ∟ texts Object[] 文本审核结果
        ∟ snippet String 命中片段
        ∟ description String 审核备注
       ∟ images Object[] 图片审核结果
        ∟ url String 图片地址
        ∟ description String 审核备注
       ∟ audios Object[] 音频审核结果
        ∟ startTime Number 位置信息,断句开始时间点,单位秒
        ∟ endTime Number 位置信息,断句结束时间点,单位秒
        ∟ startTimeMillis Number 位置信息,断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 位置信息,断句结束时间点,单位毫秒
        ∟ description String 审核备注
       ∟ videos Object[] 视频审核结果
        ∟ startTime Number 位置信息,截图开始时间点,单位秒
        ∟ endTime Number 位置信息,截图结束时间点,单位秒
        ∟ description String 审核备注
        ∟ url String 图片地址
      ∟ censorLabels Object[] 审核标签列表,人审打标的内容列表
       ∟ code String 标签编码
       ∟ name String 名称
       ∟ desc String 描述
       ∟ customCode String 用户自定义编码
     ∟ language Object 语种检测结果,如有需要请联系您的专属商务,未开通状态下不返回
      ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ callback String 提交时传递的callback
      ∟ details Object[] 命中的详细对象信息
       ∟ type String 语音识别后语种,支持检测语种类型请参考语种代码表
       ∟ segments Object[] 命中的断句时间段
        ∟ startTime Number 位置信息,断句开始时间点,单位秒
        ∟ endTime Number 位置信息,断句结束时间点,单位秒
        ∟ startTimeMillis Number 位置信息,断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 位置信息,断句结束时间点,单位毫秒
     ∟ voice Object 人声属性检测结果,如有需要请联系您的专属商务,未开通状态下不返回
      ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ callback String 提交时传递的callback
      ∟ detail Object 命中的详细对象信息
       ∟ mainGender String 命中的性别 "female" / "male"
     ∟asr Object 语音识别检测结果,如有需要请联系您的专属商务,未开通状态下不返回
      ∟ taskId String 检测任务 ID,示例值:"38e08da8d2574df4bd2eca9b5153df72"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ callback String 提交时传递的callback
      ∟ details Object[] 命中的详细对象信息
       ∟ startTime Number 位置信息,断句开始时间点,单位秒
       ∟ endTime Number 位置信息,断句结束时间点,单位秒
       ∟ startTimeMillis Number 位置信息,断句开始时间点,单位毫秒
       ∟ endTimeMillis Number 位置信息,断句结束时间点,单位毫秒
       ∟ content String 音频数据所在断句语音识别原文内容
     ∟ ocr Object OCR结果信息,OCR功能需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ pictures Object[] 截图OCR结果数组,最多返回视频截图的前100张
       ∟ startTime Number 位置信息,截图开始时间点,单位秒
       ∟ endTime Number 位置信息,截图结束时间点,单位秒
       ∟ pictureId String 截图id
       ∟ height Number 截图高度,单位像素
       ∟ width Number 截图宽度,单位像素
       ∟ url String 截图下载链接
       ∟ details Object[] 截图 OCR 命中的详细信息
        ∟ content String 该图片中所有的文字信息集合
        ∟ lineContents Object[] OCR行信息
         ∟ lineContent String 每行的文字信息
         ∟ lang String 语种信息
         ∟ x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
         ∟ y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
         ∟ x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
         ∟ y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标
     ∟ discern Object 物体识别结果,支持对截图中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ pictures Object[] 物体识别结果数组,最多返回视频截图的前100张
       ∟ startTime Number 位置信息,截图开始时间点,单位秒
       ∟ endTime Number 位置信息,截图结束时间点,单位秒
       ∟ pictureId String 截图id
       ∟ details Object[] 物体识别命中的详细信息
        ∟ discernName String 识别物体名称
        ∟ rate Number 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。
        ∟ type Number 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别,5:动漫识别,6:服饰识别,7:地图截图识别,8:聊天截屏识别,9:手机识别,10:举白纸识别,11:哺乳照识别,12:可爱卡通骷髅识别
     ∟ logo Object logo检测结果,logo检测支持对图片中包含的通识logo进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空
      ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟ pictures Object[] 物体识别结果数组,最多返回视频截图的前100张
       ∟ startTime Number 位置信息,截图开始时间点,单位秒
       ∟ endTime Number 位置信息,截图结束时间点,单位秒
       ∟ pictureId Number 截图id
       ∟ details Object[] 命中的详细信息
        ∟ logoName String logo名字,不可识别则为空
        ∟ x1 Number logo位置信息,对应logo矩形左上角横坐标相对坐标
        ∟ y1 Number logo位置信息,对应logo矩形左上角纵坐标相对坐标
        ∟ x2 Number logo位置信息,对应logo矩形右下角横坐标相对坐标
        ∟ y2 Number logo位置信息,对应logo矩形右下角纵坐标相对坐标
        ∟ rate String 置信度分数 ,置信度0-1,越接近1,置信度越高
        ∟ sizeRatio String logo占百分比大小
     ∟ quality Object 质量检测结果,质量检测需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空
      ∟ video Object 视频截图质量检测结果
       ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ pictures Object[] 视频截图质量检测结果数组,最多返回视频截图的前100张
        ∟ startTime Number 位置信息,截图开始时间点,单位秒
        ∟ endTime Number 位置信息,截图结束时间点,单位秒
        ∟ pictureId String 截图id
        ∟ 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:不包含边框
          ∟ color Object 图片边框颜色信息
           ∟ top Number 图片顶部边框颜色,1-白色,2-黑色
           ∟ right Number 图片右侧边框颜色,1-白色,2-黑色
           ∟ bottom Number 图片底部边框颜色,1-白色,2-黑色
           ∟ left Number 图片底部边框颜色,1-白色,2-黑色
         ∟ backgroundInfo Object 图片背景信息
          ∟ pureBackground boolean 纯色背景检测,ture:背景纯色;false:背景复杂
      ∟ audio Object 音频断句质量检测结果
       ∟ taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
       ∟ dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
       ∟ callback String 提交数据时的 callback
       ∟ silentSegments Object 音频无声断句检测结果详情
        ∟ startTime Number 断句开始时间点,单位秒
        ∟ endTime Number 断句结束时间点,单位秒
        ∟ startTimeMillis Number 断句开始时间点,单位毫秒
        ∟ endTimeMillis Number 断句结束时间点,单位毫秒
     ∟face Object 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下此对象返回为空
      ∟taskId String 检测任务ID,示例值:"fx6sxdcd89fvbvg4967b4787d78a"
      ∟dataId String 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟pictures Object[] 视频截图人脸检测结果数组,最多返回视频截图的前100张
       ∟startTime Number 位置信息,截图开始时间点,单位秒
       ∟endTime Number 位置信息,截图结束时间点,单位秒
       ∟url String 截图下载链接
       ∟details Object[] 截图人脸检测详情数组
        ∟faceNumber Number 该图片中包含的人脸个数
        ∟deepfake Number 是否有伪造人脸,0-无,1-有
        ∟faceContents Object[] 人脸详细信息
         ∟name String 图片中出现的人脸名字,未识别则为空。该字段可识别明星、政治人物等人脸信息,用于落马官员/劣迹艺人检测,或明星头像/政治头像检测
         ∟glasses String 人脸戴眼镜,normal(无眼镜)、 glasses(普通眼镜)、 sunglasses(墨镜),如有需要请联系您的专属商务,未开通状态下不返回该字段
         ∟gender String 人脸性别,值为男(male)、女(female);不可识别则为空
         ∟age Number 人脸年龄,值为具体年龄(age);不可识别则为空
         ∟growthStage String 成长阶段(未成年,成年),值为child(未成年幼态),young(非幼态未成年),adult(成年)
         ∟type String 人脸类型,包含卡通脸(cartoon)、普通(normal),如有需要请联系您的专属商务,未开通状态下不返回该字段
         ∟category String 人物分类,包含名人(star)、普通(normal)、海外娱乐明星(overseaEntertainmentStar)、海外体育明星(overseaSportStar)、海外政客(overseaPolitician)、海外网红(overseaInternetStar)
         ∟maskType String mask(有遮挡),normal(无遮挡)。判断人脸是否有遮挡,可以用于判断用户是否佩戴口罩墨镜纱巾等综合性遮挡场景
         ∟expression String 人脸情绪:neutral(扮酷),happy(微笑),sad(悲伤),surprise(惊讶),fear(害怕),anger(生气),disgust(不喜欢),如有需要请联系您的专属商务,未开通状态下不返回该字段
         ∟beautyScore Number 人脸颜值分数,0-1,保留4位小数,如有检测需求请联系易盾策略经理开启服务,如有需要请联系您的专属商务,未开通状态下不返回该字段
         ∟sizeRatio String 人脸占比,百分比形式
         ∟x1 Number 位置信息,对应目标矩形左上角横坐标相对坐标
         ∟y1 Number 位置信息,对应目标矩形左上角纵坐标相对坐标
         ∟x2 Number 位置信息,对应目标矩形右下角横坐标相对坐标
         ∟y2 Number 位置信息,对应目标矩形右下角纵坐标相对坐标

    请求体示例

    callbackData=***&signature=xxx&secretId=xxx
    

    请求体callbackData格式如下,callbackData为json字符串格式,请自行解析或者反转成json对象使用

    {
        "antispam":{
            "taskId":"18xrunm6fr35t49nnv506ukg02009q66",
            "suggestion":2,
            "status":2,
            "resultType":1,
            "censorSource":2,
            "checkTime":1633759861164,
            "censorTime":1633759853762,
            "duration":71339,
            "censorLabels":[
                {
                    "code":101,
                    "desc":"自定义标签",
                    "customCode":"68684"
                }
            ],
            "evidences":{
                "images":[
                    {
                        "censorType":0,
                        "labels":[
                            {
                                "label":100,
                                "level":2,
                                "rate":0.9999,
                                "subLabels":[
                                    {
                                        "details":{
                                            "hitInfos":[
                                                {
                                                    "group":"色情部位分组",
                                                    "value":"女胸"
                                                }
                                            ]
                                        },
                                        "rate":1,
                                        "subLabel":10002
                                    }
                                ]
                            },
                            {
                                "label":500,
                                "level":0,
                                "rate":0.9999
                            },
                            {
                                "label":300,
                                "level":0,
                                "rate":1
                            },
                            {
                                "label":400,
                                "level":0,
                                "rate":1
                            },
                            {
                                "label":200,
                                "level":0,
                                "rate":0.9975
                            }
                        ],
                        "name":"gpqis0e92czvfliemjpa3neg02009q6a",
                        "resultType":1,
                        "status":2,
                        "suggestion":2,
                        "taskId":"0b2dd0e561a8457fbfcf7d79378eec37"
                    }
                ],
                "text":{
                    "taskId":"44i3effo1j5w5for9l8xtdjg02009q6a",
                    "suggestion":2,
                    "resultType":1,
                    "censorType":0,
                    "isRelatedHit":false,
                    "labels":[
                        {
                            "label":200,
                            "level":2,
                            "subLabels":[
                                {
                                    "subLabel":"200009",
                                    "details":{
                                        "hitInfos":[
                                            {
                                                "value":"加我",
                                                "positions":[
                                                    {
                                                        "fieldName":"content",
                                                        "startPos":5,
                                                        "endPos":8
                                                    },
                                                    {
                                                        "fieldName":"title",
                                                        "startPos":5,
                                                        "endPos":8
                                                    }
                                                ]
                                            }
                                        ]
                                    }
                                }
                            ]
                        }
                    ]
                },
                "audio":{
                    "taskId":"18xrunm6fr35t49nnv506ukg02009q66",
                    "dataId":"",
                    "status":2,
                    "suggestion":2,
    		"label":100,
                    "resultType":1,
                    "callback":"",
                    "censorSource":2,
                    "censorTime":1633759861065,
                    "segments":[
                        {
                            "startTime":0,
                            "endTime":6,
                            "content":"第一次用这个软件上了半天,全是长得漂亮呢?",
                            "type":0,
                            "labels":[
                                {
                                    "label":100,
                                    "level":2,
                                    "subLabels":[
                                        {
                                            "subLabel":"100001",
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "value":"120",
                                                        "startTime":1684201,
                                                        "endTime":1684201,
                                                        
                                                    }
                                                ],
                                                "keywords":[
                                                    {
                                                        "word":"自定义敏感词"
                                                    }
                                                ],
                                                "libInfos":[
                                                    {
                                                        "listType":1,
                                                        "entity":"127.0.0.1"
                                                    }
                                                ]
                                            }
                                        }
                                    ]
                                }
                            ]
                        },
                        {
                            "startTime":52,
                            "endTime":53,
                            "content":"哦。",
                            "type":0,
                            "labels":[
    
                            ]
                        }
                    ],
                    "duration":71
                },
                "video":{
                    "taskId":"18xrunm6fr35t49nnv506ukg02009q66",
                    "dataId":"",
                    "status":2,
                    "suggestion":2,
                    "resultType":1,
                    "censorSource":2,
                    "censorTime":1633759858920,
                    "pictures":[
                        {
                            "type":1,
                            "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_1_5000.jpg?Signature=zAyZL%2B8cuIZlQyAguVxzeXtoSB20NYykv32i9IQpdQI%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8",
                            "startTime":5000,
                            "endTime":5000,
                            "labels":[
                                {
                                    "label":100,
                                    "level":2,
                                    "rate":0.95157,
                                    "subLabels":[
                                        {
                                            "subLabel":10007,
                                            "rate":0.926,
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "value":"卡通色情",
                                                        "group":"色情部位分组"
                                                    }
                                                ]
                                            }
                                        }
                                    ]
                                }
                            ],
                            "censorSource":2,
                            "frontPics":[
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_0_0.jpg?Signature=OLZBW0E1tD21RTp7JD58hB1xuwwhd%2FDbeMXFSxOTL%2FU%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                }
                            ],
                            "backPics":[
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_2_10000.jpg?Signature=6mtVdESs0R%2BwzRVE%2BmVYT8RVVh1nllu%2FO1dkaQJwMAc%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                },
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_3_15000.jpg?Signature=qekds78dhYRIrhXw6NK7Xh88nW18FObulqA6aPU7Mcg%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                },
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_4_20000.jpg?Signature=ZyrIX4TJP5MpOYoPRhVTf6L%2BelcNJFlnt7t8J7ucwKk%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                }
                            ]
                        },
                        {
                            "type":1,
                            "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_2_10000.jpg?Signature=6mtVdESs0R%2BwzRVE%2BmVYT8RVVh1nllu%2FO1dkaQJwMAc%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8",
                            "startTime":10000,
                            "endTime":10000,
                            "labels":[
                                {
                                    "label":100,
                                    "level":2,
                                    "rate":0.95157,
                                    "subLabels":[
                                        {
                                            "subLabel":10007,
                                            "rate":0.926,
                                            "details":{
                                                "hitInfos":[
                                                    {
                                                        "value":"卡通色情",
                                                        "group":"色情部位分组"
                                                    }
                                                ]
                                            }
                                        }
                                    ]
                                }
                            ],
                            "censorSource":2,
                            "frontPics":[
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_0_0.jpg?Signature=OLZBW0E1tD21RTp7JD58hB1xuwwhd%2FDbeMXFSxOTL%2FU%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                },
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_1_5000.jpg?Signature=zAyZL%2B8cuIZlQyAguVxzeXtoSB20NYykv32i9IQpdQI%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                }
                            ],
                            "backPics":[
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_3_15000.jpg?Signature=qekds78dhYRIrhXw6NK7Xh88nW18FObulqA6aPU7Mcg%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                },
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_4_20000.jpg?Signature=ZyrIX4TJP5MpOYoPRhVTf6L%2BelcNJFlnt7t8J7ucwKk%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                },
                                {
                                    "url":"https://illegal-video.nosdn.127.net/18xrunm6fr35t49nnv506ukg02009q66_5_25000.jpg?Signature=exB1s%2BEQoMq%2FL4BZqyMofQB8H%2FwkiinkpFjG39mDpl0%3D&Expires=1636351861&NOSAccessKeyId=7ec43af9b5bf4ca5975204de64396ee8"
                                }
                            ]
                        }
                    ],
                    "duration":71
                }
            }
        },
        "language":{
            "taskId":"38e08da8d2574df4bd2eca9b5153df72",
            "dataId":"",
            "callback":"",
            "details":[
                {
                    "type":"en-GB",
                    "segments":[
                        {
                            "startTime":35,
                            "endTime":40
                        },
                        {
                            "startTime":160,
                            "endTime":165
                        }
                    ]
                }
            ]
        },
        "asr":{
            "taskId":"38e08da8d2574df4bd2eca9b5153df72",
            "dataId":"",
            "callback":"",
            "details":[
                {
                    "startTime":0,
                    "endTime":15,
                    "content":"5月15日,我国首次火星探测任务着陆火星取得成功。"
                }
            ]
        },
        "voice":{
            "taskId":"7f03cdeaf4cf4c748a4edbe97833a9ee",
            "dataId":"",
            "callback":"",
            "details":{
                "mainGender":"male"
             }
            
        },
        "discern":{
    	"taskId":"33a188743184455683405c1fe8c5a74f",
            "dataId":"",
            "pictures":{
                        "startTime":"1675070777",
    		    "endTime":"1675070777",
    		    "details":{
    		       "discernName":"识别物品名称",
    		       "rate":0.998,
    		       "type":3
    		   }
                   }
    	 }
    }
    

    响应

    响应结果

    • 客户接口接收到我们回调的结果后,需要返回应答信息,接口响应HTTP状态码为200,当回调处理异常时,应答的HTTP状态码应为500,或者4xx;
    • 目前推送方式默认连接超时(connect timeout)150ms,回调超时(socket timeout)为2s,建议收到推送检测结果后,优先返回reponse应答信息,异步处理检测结果,避免因为回调超时,易盾侧未收到响应重复推送结果。如业务侧对于超时配置有特殊要求,可联系易盾策略经理调整配置。
    • 应答信息为json格式,字段定义如下:
    名称 类型 必须返回 描述
    code Number 应答code,易盾方解析code为200表示推送成功
    msg String 具体描述信息

    响应体示例

    { 
        "code": 200, 
        "msg": "接收成功"
    }
    
    Online Chat Tel:95163223 Free trial