Help Center

    查询截图

    2025.03.28 17:18:39

      内容安全直播音视频查询视频截图，客户可以通过轮询调用该接口获取数据。

      接口说明

      该接口支持客户根据提交检测时返回的taskId查询视频的截图内容，需要客户通过该接口进行定时轮询获取。

      鉴权说明

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

      结果说明

      • 接口一次最多返回1000个结果，最多查询7天内的提交的直播
      • 接口请求频率建议1s一次，过快服务器会拒绝处理，客户可以根据业务需求进行适当调整

      接口耗时

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

      请求

      请求地址

      名称 值
      HTTP URL http://as.dun.163.com/v1/livewallsolution/query/image
      HTTP Method POST

      请求头

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

      请求参数

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

      公共参数

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

      业务参数

      名称 类型 必填 最大长度 描述
      version String 是 4 接口版本v1
      taskId String 是 32 直播音视频taskId，示例值："38e08da8d2574df4bd2eca9b5153df72"
      levels String 是 8 直播截图嫌疑级别，String形式的数组，0: 正常，1: 嫌疑，2: 确定，如 "[1,2]"
      callbackStatus Number 否 1 回调状态，0: 不需要回调，1: 等待回调，2: 已回调，3: 回调失败
      startTime Number 否 13 查询起始时间，单位毫秒
      endTime Number 否 13 查询结束时间，单位毫秒
      pageNum Number 是 13 查询页码，从1开始
      pageSize Number 是 4 每页查询数据条数，大于0，上限1000

      请求体示例

      version=v1&signature=xxx&secretId=xxx&taskId=38e08da8d2574df4bd2eca9b5153df72&levels=[1,2]&pageNum=1&pageSize=100

      响应

      该接口可以返回直播音视频机器检测截图信息。

      响应结果

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

      名称 类型 必须返回 描述
      result Object[] 是 直播音视频检测结果
       ∟ status Number 是 查询结果，0-成功，20-非7天提交的直播，30-直播不存在
       ∟ images Object 是 截图查询结果
        ∟ count Number 是 截图总数
        ∟ rows Object[] 是 截图数据列表
         ∟ url String 是 截图地址
         ∟ label Number 是 分类信息，100：色情，200：广告，400：违禁，500：涉政，600：谩骂，700：灌水
         ∟ labelLevel Number 是 分类级别，0-正常，1-嫌疑，2-删除
         ∟ callbackStatus Number 是 回调状态，0-不需要回调，1-待回调，2-已回调，3-回调失败
         ∟ beginTime Number 是 截图开始时间，单位毫秒
         ∟ endTime Number 是 截图结束时间，单位毫秒
         ∟ speakerId String 否 针对接入SDK监听客户，返回说话人ID信息

      响应体示例

      {
    "code": 200,
	"msg": "ok",
	"result": {
        "status": 0,
        "images": {
            "count": 3,
            "rows": [
                {
                  "url": "xxxxxxxxx",
                  "label": 200,
                  "labelLevel": 1,
                  "beginTime": 1588056782734,
                  "endTime": 1588056700000
                }
            ]
        }
    }
}

      响应返回码

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

      示例代码

      服务端 SDK 接入

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

      Github Demo 地址

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

      HTTP API 接入

      Github Demo 地址

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

      Comment On The Document:

      If you encounter product-related problems, you can Submit a ticket 或 Online Chat Seek help.

      Online Chat Tel：95163223 Free trial