内容安全直播视频异步检测或人工审核的结果，客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥，只能选取一种模式进行结果获取。

接口说明

该接口返回直播视频经过机器检测或者人工审核的结果，需要客户通过该接口进行定时轮询获取，当提交检测接口参数callbackUrl为空时，表示结果通过该接口获取，结果可以根据提交检测时返回的taskId对应。

鉴权说明

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

结果说明

• 获取结果后，下次调用，不会再次返回之前获取过的结果
• 接口一次最多返回200个结果，审核结果数据默认保留7天，7天不获取会失效
• 接口请求频率建议1s一次，过快服务器会拒绝处理，客户可以根据业务需求进行适当调整

接口耗时

结果获取接口的响应很快，正常50ms内返回结果，业务方根据需求适当调整超时时间，建议为1s

历史版本

v2版本直播视频轮询模式获取检测结果请点此查看

请求

请求地址

名称	值
HTTP URL	http://as.dun.163.com/v4/livevideo/callback/results
HTTP Method	POST

请求头

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

请求参数

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

公共参数

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

业务参数

名称	类型	必填	最大长度	描述
version	String	是	4	接口版本v4
yidunRequestId	String	否	64	幂等参数说明

请求体示例

version=v4&signature=xxx&secretId=xxx&businessId=xxx

响应

该接口可以返回人工审核结果或异步机器检测结果，两类结果结构保持一致。

响应结果

响应字段如下，响应公共字段已省略，详细见响应公共字段，详细字段信息如下：

名称	类型	必须返回	描述
result	Object[]	是	视频检测结果
∟ antispam	Object	否	内容安全检测结果
∟ taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟ callback	String	否	提交时传递的callback
∟ dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟ censorSource	Number	是	审核来源，0：易盾人审，1：客户人审，2：易盾机审
∟ status	Number	是	检测状态，1-检测中，2-检测成功，3-检测失败
∟ failureReason	Number	否	检测失败原因，当检测失败时返回，1：下载失败，2：直播流不存在，3：解析失败，4：格式错误
∟ riskLevel	Number	否	直播异常风险等级， 0-正常，1-低危，2-中危，3-中高危，4-高危
∟ riskScore	Number	否	直播异常分数
∟ duration	Number	否	直播开播到结束的总时长，单位s
∟ strategySource	Number	否	策略来源，0：易盾策略来源，1：客户策略来源
∟ evidences	Object	否	直播截图审核证据信息
∟ evidence	Object	否	证据信息
∟ suggestion	Number	是	建议结果 0-通过 1-嫌疑 2-删除
∟ label	Number	是	分类信息，100：色情，110：性感低俗，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，800：恶心类，900：其他，1020：黑屏，1030：挂机，1100：涉价值观
∟secondLabel	String	否	命中二级标签细分类
∟thirdLabel	String	否	命中三级标签细分类
∟ suggestionLevel	Number	否	嫌疑级别，针对部分定制策略支持命中嫌疑时返回，1：低嫌疑，2：高嫌疑，对通用策略、模型结果暂不支持，v5.2版本新增，默认不返回，如果需要返回请联系运营经理配置
∟ type	Number	是	证据信息类型，1-图片，2-视频
∟ url	String	是	证据信息内容
∟ beginTime	Number	是	直播当前时间点，单位为毫秒
∟ endTime	Number	是	直播当前时间点，单位为毫秒
∟ speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟ frontPics	Object[]	否	关联信息-命中前截图信息
∟ url	String	是	命中前截图信息
∟ 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	是	细分类，详细编码请参考下方对应细分类编码对照表
∟ 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的解释
∟ hitInfos	Object[]	否	命中的线索信息
∟ value	String	是	图片中包含的可识别内容
∟ group	String	否	value对应的分组名称，用于对value的解释
∟ x1	Number	否	位置信息，对应目标矩形左上角横坐标相对坐标
∟ y1	Number	否	位置信息，对应目标矩形左上角纵坐标相对坐标
∟ x2	Number	否	位置信息，对应目标矩形右下角横坐标相对坐标
∟ y2	Number	否	位置信息，对应目标矩形右下角纵坐标相对坐标
∟ anticheat	Object	否	命中的反作弊信息
∟ hitType	Number	是	反作弊命中类型，详见hitType返回码及含义表
∟ rules	Object[]	否	命中用户自定义的规则信息
∟ name	String	是	规则名
∟ ocr	Object	否	OCR结果信息，OCR功能需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回
∟ taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟ dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟ speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟ beginTime	String	是	直播当前时间点，单位为毫秒
∟ endTime	String	是	直播当前时间点，单位为毫秒
∟ height	Number	是	截图高度，单位像素
∟ width	Number	是	截图宽度，单位像素
∟ details	Object[]	否	截图 OCR 命中的详细信息
∟ content	String	是	该图片中所有的文字信息集合
∟ lineContents	Object[]	是	OCR行信息
∟ lineContent	String	是	每行的文字信息
∟ lang	String	否	语种信息
∟ x1	Number	否	位置信息，对应目标矩形左上角横坐标相对坐标
∟ y1	Number	否	位置信息，对应目标矩形左上角纵坐标相对坐标
∟ x2	Number	否	位置信息，对应目标矩形右下角横坐标相对坐标
∟ y2	Number	否	位置信息，对应目标矩形右下角纵坐标相对坐标
∟ discern	Object	否	图片个性化内容识别结果，支持对截图中物体进行识别，识别结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回
∟ taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟ dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟ speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟ beginTime	String	是	直播当前时间点，单位为毫秒
∟ endTime	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：可爱卡通骷髅识别
∟ logo	Object	否	logo检测结果，logo检测支持对图片中包含的通识logo进行识别，检测结果返回需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回
∟ taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟ dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟ speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟ beginTime	String	是	直播当前时间点，单位为毫秒
∟ endTime	String	是	直播当前时间点，单位为毫秒
∟ 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	否	视频截图质量检测结果，质量检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回
∟ taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟ dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟ speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟ beginTime	String	是	直播当前时间点，单位为毫秒
∟ endTime	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	否	图片是否包含边框（任一边包含边框均视为包含）true：包含边框；false：不包含边框
∟ top	Boolean	否	图片顶部是否包含边框，true：包含边框；false：不包含边框
∟ right	Boolean	否	图片右侧是否包含边框，true：包含边框；false：不包含边框
∟ bottom	Boolean	否	图片底部是否包含边框，true：包含边框；false：不包含边框
∟ left	Boolean	否	图片底部是否包含边框，true：包含边框；false：不包含边框
∟ color	Object	否	图片边框颜色信息
∟ top	Number	否	图片顶部边框颜色，1-白色，2-黑色
∟ right	Number	否	图片右侧边框颜色，1-白色，2-黑色
∟ bottom	Number	否	图片底部边框颜色，1-白色，2-黑色
∟ left	Number	否	图片底部边框颜色，1-白色，2-黑色
∟ backgroundInfo	Object	否	图片背景信息
∟ pureBackground	boolean	否	纯色背景检测，true：背景纯色；false：背景复杂
∟face	Object	否	人脸检测信息，人脸检测结果需额外付费开启，如有需要请联系您的专属商务，未开通状态下不返回
∟taskId	String	是	易盾侧机审数据唯一标识，能够根据该值定位到该条数据，如对检测结果有异议，可以发送该值给策略经理查询
∟dataId	String	否	上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给客户经理查询
∟speakerId	String	否	针对接入SDK监听客户，返回说话人ID信息
∟beginTime	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位小数，如有检测需求请联系易盾策略经理开启服务，如有需要请联系您的专属商务，未开通状态下不返回该字段
∟ completeness	Number	否	人脸完整性，0：不完整，1：完整，2：未知，如有需要请联系您的专属商务，未开通状态下不返回该字段
∟sizeRatio	String	否	人脸占比，百分比形式
∟x1	Number	否	位置信息，对应目标矩形左上角横坐标相对坐标
∟y1	Number	否	位置信息，对应目标矩形左上角纵坐标相对坐标
∟x2	Number	否	位置信息，对应目标矩形右下角横坐标相对坐标
∟y2	Number	否	位置信息，对应目标矩形右下角纵坐标相对坐标

响应体示例

{
  "code": 200,
  "msg": "ok",
  "result": [
    {
      "antispam": {
        "taskId": "09f0da093c334673b557266801158778",
        "dataId": "1631935360902",
        "censorSource": 2,
        "status": 1,
        "evidences": {
          "evidence": {
            "suggestion": 2,
            "type": 1,
            "url": "https://yidun-video.nos-eastchina1.126.net/09f0da093c334673b557266801158778_65108_1631935372803.jpg?Signature=TZ6%2Bwbg9w4L3nIXbcjwXOCdWLGGi4K2xHrRKj2%2BFWeo%3D&Expires=1634527373&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff",
            "beginTime": 1631935372765,
            "endTime": 1631935372765,
            "speakerId": "65108",
            "frontPics": [
              {
                "url": "https://yidun-video.nos-eastchina1.126.net/09f0da093c334673b557266801158778_65108_1631935362135.jpg?Signature=DC8L2OwyitZGAKYFG9m%2FeVWKLQm9jiapHzLgipi%2B3OM%3D&Expires=1634527373&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
              },
              {
                "url": "https://yidun-video.nos-eastchina1.126.net/09f0da093c334673b557266801158778_65108_1631935367629.jpg?Signature=s3hsY8zuhAxI9byiwN02m4YLjftIp6bcROSVvyo%2FuTM%3D&Expires=1634527373&NOSAccessKeyId=7b107844ee8e4f9689d54c726e3273ff"
              }
            ]
          },
          "labels": [
            {
              "label": 100,
              "level": 2,
              "rate": 0.999936,
              "subLabels": [
                {
                  "subLabel": 10002,
                  "rate": 0.9998,
                  "details": {
                    "hitInfos": [
                      {
                        "value": "女胸",
                        "group": "色情部位分组"
                      }
                    ]
                  }
                },
                {
                  "subLabel": 10004,
                  "rate": 0.988,
                  "details": {
                    "hitInfos": [
                      {
                        "value": "性行为",
                        "group": "色情部位分组"
                      }
                    ]
                  }
                }
              ]
            }
          ]
        },
        "riskLevel": 0,
        "riskScore": 0
      },
      "face": {
        "dataId": "1631935360902",
        "speakerId": "",
        "details": [
          {
            "faceContents": [
              {
                "expression": "sad",
                "maskType": "mask",
                "gender": "female",
                "type": "cartoon",
                "glasses": "glasses",
                "growthStage": "adult",
                "name": "others",
                "y1": 0.2421,
                "x1": 0.3464,
                "y2": 1,
                "x2": 0.7915,
                "category": "normal",
                "beautyScore": 0.83,
                "age": 19
              }
            ],
            "faceNumber": 1
          }
        ],
        "beginTime": 1681376062147,
        "endTime": 1681376062147,
        "taskId": "09f0da093c334673b557266801158778",
        "url": "https://yidun-antispam-archive.vod.126.net/ap41el7txlr9s6o5owjcwjrg0400a0dk__1681376068298.jpg?Signature=PzMNV2X9NXLO3aiG2wNteJm6Nxi2B82OUKIf%2FAc6yWM%3D&Expires=1686560068&NOSAccessKeyId=e36babfdcb884368b4e72670e1a08d6a"
      }
    }
  ]
}

响应返回码

响应返回码见：响应返回码

示例代码

服务端 SDK 接入

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

Github Demo 地址

• Java SDK Demo

Gitee Demo 地址（Github 无法访问时选择）

• Java SDK Demo

HTTP API 接入

Github Demo 地址

• PHP Demo
• Python Demo
• Golang Demo
• Node.js Demo
• C# Demo
• Java Demo

Gitee Demo 地址（Github 无法访问时选择）

• PHP Demo
• Python Demo
• Golang Demo
• Node.js Demo
• C# Demo
• Java Demo