视频直播检测结果获取接口

接口地址

http://as.dun.163.com/v2/livevideo/callback/results

接口描述

该接口用于获取直播流检测结果,检测结果包含截图证据信息及违规分类信息等。

接口请求频率

小于10s/20次,请求频率过快服务器会拒绝处理。

请求参数

该接口参数与请求公共参数一致,详细见 请求公共参数

响应结果

响应字段如下,响应通用字段已省略,详细见 响应通用字段

参数名称类型描述
resultjson数组检测结果数组

result 数据结构

参数名称类型描述
statusNumber视频处理状态码,定义为:101:检测中,102:检测结束
taskIdString本次请求数据标识,可以根据该标识查询数据最新结果
callbackString产品提交直播流信息时带的 callback 字段数据,用于标识直播流,产品根据业务情况自行设计
evidencejson对象证据信息
labelsjson数组检测结果数组,如为空,则表示内容正常,如不为空,则表示检测到违规信息

evidence数据结构:

参数名称类型描述
beginTimeNumber证据开始时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29"
endTimeNumber证据结束时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29"
typeNumber1:图片,2:视频
urlString证据信息

证据时间戳说明

◆ 证据信息命中黑屏挂机后,type为视频,开始时间和结束时间为证据采集时对应截帧一刻的本地时间。其他垃圾类别,证据开始时间与结束时间一致

labels数据结构

参数名称类型描述
labelNumber分类信息,100:色情,110:性感;200:广告,210:二维码;300:暴恐,400:违禁,500:涉政,1020:黑屏,1030:挂机
subLabelsjson数组细分类信息,可能包含多个,可能为空
levelNumber级别信息,分为1:不确定,2:确定
rateNumber分数

subLabels 数据结构

参数名称类型描述
subLabelNumber细分类,详细编码请参考下方对应细分类编码对照表
rateNumber置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
detailsjson数组htiInfos:命中详细信息

subLabel细分类编码对应表

返回编码描述hitInfos
10000色情若命中图片中文字检测策略,可返回文字线索信息
10001女下体-
10002女胸-
10003男下体-
10004性行为-
10005臀部-
10006口交-
10007卡通色情-
10008色情人物人物名
10009儿童色情-
11000性感低俗-
11001亲吻-
11002腿部特写-
11003赤膊-
11004胸部-
20000广告若命中图片中文字检测策略,可返回文字线索信息
20001广告带文字
21000二维码若命中图片中文字检测策略,可返回文字线索信息
30000暴恐若命中图片中文字检测策略,可返回文字线索信息
30001暴恐图集-
30002暴恐旗帜旗帜名
30003暴恐人物人物名
30004暴恐标识标识名
30005暴恐场景场景名
40000违禁若命中图片中文字检测策略,可返回文字线索信息
40001违禁图集-
40002违禁品违禁品名
40003特殊标识标识名
40004血腥模型-
40005公职服饰服饰名
40006不文明不文明行为
40007违禁人物人物名
40008违禁场景场景名
40009火焰-
40010骷髅-
40011货币-
40012毒品-
50000涉政若命中图片中文字检测策略,可返回文字线索信息
50001涉政图集-
50002中国地图-
50003涉政人物人物名
50004涉政旗帜旗帜名
50005涉政标识标识名
50006涉政场景场景名

自定义细分类

易盾支持subLabel自定义细分类过检并返回,如有需求,可联系您的专属运营经理添加。

请求示例

/*
 * @(#) LiveVideoCallbackAPIDemo.java 2016年8月1日
 *
 * Copyright 2010 NetEase.com, Inc. All rights reserved.
 */
package com.netease.is.antispam.demo.v2;

import java.util.HashMap;
import java.util.Map;
import java.util.Random;

import org.apache.http.Consts;
import org.apache.http.client.HttpClient;

import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import com.netease.is.antispam.demo.utils.HttpClient4Utils;
import com.netease.is.antispam.demo.utils.SignatureUtils;

/**
 * 调用云安全反垃圾云服务视频直播检测结果获取接口API示例,该示例依赖以下jar包:
 * 1. httpclient,用于发送http请求
 * 2. commons-codec,使用md5算法生成签名信息,详细见SignatureUtils.java
 * 3. gson,用于做json解析
 *
 * @author hzgaomin
 * @version 2016年8月1日
 */
public class LiveVideoCallbackAPIDemo {
    /** 产品密钥ID,产品标识 */
    private final static String SECRETID = "your_secret_id";
    /** 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露 */
    private final static String SECRETKEY = "your_secret_key";
    /** 业务ID,云安全根据产品业务特点分配 */
    private final static String BUSINESSID = "your_business_id";
    /** 云安全反垃圾云服务视频直播检测结果获取接口地址 */
    private final static String API_URL = "http://as.dun.163.com/v2/livevideo/callback/results";
    /** 实例化HttpClient,发送http请求使用,可根据需要自行调参 */
    private static HttpClient httpClient = HttpClient4Utils.createHttpClient(100, 20, 10000, 1000, 1000);

    /**
     *
     * @param args
     * @throws Exception
     */
    public static void main(String[] args) throws Exception {
        Map<String, String> params = new HashMap<String, String>();
        // 1.设置公共参数
        params.put("secretId", SECRETID);
        params.put("businessId", BUSINESSID);
        params.put("version", "v2.1");
        params.put("timestamp", String.valueOf(System.currentTimeMillis()));
        params.put("nonce", String.valueOf(new Random().nextInt()));

        // 2.生成签名信息
        String signature = SignatureUtils.genSignature(SECRETKEY, params);
        params.put("signature", signature);

        // 3.发送HTTP请求,这里使用的是HttpClient工具包,产品可自行选择自己熟悉的工具包发送请求
        String response = HttpClient4Utils.sendPost(httpClient, API_URL, params, Consts.UTF_8);

        // 4.解析接口返回值
        JsonObject resultObject = new JsonParser().parse(response).getAsJsonObject();
        int code = resultObject.get("code").getAsInt();
        String msg = resultObject.get("msg").getAsString();
        if (code == 200) {
            JsonArray resultArray = resultObject.getAsJsonArray("result");
            for (JsonElement jsonElement : resultArray) {
                JsonObject jObject = jsonElement.getAsJsonObject();
                String callback = jObject.get("callback").getAsString();
                JsonObject evidenceObjec = jObject.get("evidence").getAsJsonObject();
                JsonArray labelArray = jObject.get("labels").getAsJsonArray();
                if (labelArray.size() == 0) {// 检测正常
                    System.out.println(String.format("正常, callback=%s, 证据信息:%s", callback, 

evidenceObjec));
                } else {
                    for (JsonElement labelElement : labelArray) {
                        JsonObject lObject = labelElement.getAsJsonObject();
                        int label = lObject.get("label").getAsInt();
                        int level = lObject.get("level").getAsInt();
                        double rate = lObject.get("rate").getAsDouble();
                        System.out.println(String.format("异常, callback=%s, 分类:%s, 证据信息:%s", 

callback, lObject, evidenceObjec));
                    }
                }
            }
        } else {
            System.out.println(String.format("ERROR: code=%s, msg=%s", code, msg));
        }
    }
}

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
易盾反垃圾云服务视频直播离线结果获取接口python示例代码
接口文档: http://dun.163.com/api.html
python版本:python3.7
运行:
    1. 修改 SECRET_ID,SECRET_KEY,BUSINESS_ID 为对应申请到的值
    2. $ python livevideo_callback.py
"""
__author__ = 'yidun-dev'
__date__ = '2019/11/27'
__version__ = '0.2-dev'

import hashlib
import time
import random
import urllib.request as urlrequest
import urllib.parse as urlparse
import json


class LiveVideoCallbackAPIDemo(object):
    """视频直播离线结果获取接口示例代码"""

    API_URL = "http://as.dun.163.com/v2/livevideo/callback/results"
    VERSION = "v2.1"

    def __init__(self, secret_id, secret_key, business_id):
        """
        Args:
            secret_id (str) 产品密钥ID,产品标识
            secret_key (str) 产品私有密钥,服务端生成签名信息使用
            business_id (str) 业务ID,易盾根据产品业务特点分配
        """
        self.secret_id = secret_id
        self.secret_key = secret_key
        self.business_id = business_id

    def gen_signature(self, params=None):
        """生成签名信息
        Args:
            params (object) 请求参数
        Returns:
            参数签名md5值
        """
        buff = ""
        for k in sorted(params.keys()):
            buff += str(k) + str(params[k])
        buff += self.secret_key
        return hashlib.md5(buff.encode("utf8")).hexdigest()

    def check(self):
        """请求易盾接口
        Returns:
            请求结果,json格式
        """
        params = {}
        params["secretId"] = self.secret_id
        params["businessId"] = self.business_id
        params["version"] = self.VERSION
        params["timestamp"] = int(time.time() * 1000)
        params["nonce"] = int(random.random() * 100000000)
        params["signature"] = self.gen_signature(params)

        try:
            params = urlparse.urlencode(params).encode("utf8")
            request = urlrequest.Request(self.API_URL, params)
            content = urlrequest.urlopen(request, timeout=10).read()
            return json.loads(content)
        except Exception as ex:
            print("调用API接口失败:", str(ex))


if __name__ == "__main__":
    """示例代码入口"""
    SECRET_ID = "your_secret_id"  # 产品密钥ID,产品标识
    SECRET_KEY = "your_secret_key"  # 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露
    BUSINESS_ID = "your_business_id"  # 业务ID,易盾根据产品业务特点分配
    api = LiveVideoCallbackAPIDemo(SECRET_ID, SECRET_KEY, BUSINESS_ID)

    ret = api.check()

    code: int = ret["code"]
    msg: str = ret["msg"]
    if code == 200:
        resultArray: list = ret["result"]
        for result in resultArray:
            taskId: str = result["taskId"]
            callback: str = result["callback"]
            evidence: dict = result["evidence"]
            labelArray: list = result["labels"]
            if (labelArray is not None) and len(labelArray) == 0:  # 检测正常
                print("正常, taskId: %s, callback: %s, 证据信息: %s" % (taskId, callback, evidence))
            elif len(labelArray) > 0:  # 检测异常
                for labelItem in labelArray:
                    label: int = labelItem["label"]
                    level: int = labelItem["level"]
                    rate: float = labelItem["rate"]
                    print("异常, taskId: %s, callback: %s, 分类: %s, 证据信息: %s" % (taskId, callback, labelItem, evidence))
    else:
        print("ERROR: code=%s, msg=%s" % (ret["code"], ret["msg"]))
<?php
/** 直播视频检测结果查询接口 */
/** 产品密钥ID,产品标识 */
define("SECRETID", "your_secret_id");
/** 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露 */
define("SECRETKEY", "your_secret_key");
/** 业务ID,易盾根据产品业务特点分配 */
define("BUSINESSID", "your_business_id");
/** 易盾反垃圾云服务直播视频检测结果获取接口地址 */
define("API_URL", "http://as.dun.163.com/v2/livevideo/callback/results");
/** api version */
define("VERSION", "v2.1");
/** API timeout*/
define("API_TIMEOUT", 10);
require("../util.php");

/**
 * 反垃圾请求接口简单封装
 * $params 请求参数
 */
function check(){
    $params = array();
	$params["secretId"] = SECRETID;
	$params["businessId"] = BUSINESSID;
	$params["version"] = VERSION;
	$params["timestamp"] = time() * 1000;// time in milliseconds
	$params["nonce"] = sprintf("%d", rand()); // random int

	$params = toUtf8($params);
	$params["signature"] = gen_signature(SECRETKEY, $params);
	// var_dump($params);

	$result = curl_post($params, API_URL, API_TIMEOUT);
	// var_dump($result);
	if($result === FALSE){
		return array("code"=>500, "msg"=>"file_get_contents failed.");
	}else{
		return json_decode($result, true);	
	}
}

// 简单测试
function main(){
    echo "mb_internal_encoding=".mb_internal_encoding()."\n";
	$ret = check();
	var_dump($ret);

	if ($ret["code"] == 200) {
		$result = $ret["result"];
		foreach($result as $index => $value){
			$labels = $value["labels"];
			if(!empty($labels)){// labels不为空说明发现有问题
				echo "evidence = ".json_encode($value["evidence"])."\n";
				foreach ($labels as $i => $label) {
					echo "label = ".$label["label"].", level = ".$label["level"].", rate = ".$label["rate"]."\n";
				}
			}
		}
    }else{
    	var_dump($ret);
    }
}

main();
?>
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.Net.Http;

namespace Com.Netease.Is.Antispam.Demo
{
    class LiveVideoCallbackApiDemo
    {
        public static void liveVideotCallBack()
        {
            /** 产品密钥ID,产品标识 */
            String secretId = "your_secret_id";
            /** 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露 */
            String secretKey = "your_secret_key";
            /** 业务ID,云安全根据产品业务特点分配 */
            String businessId = "your_business_id";
            /** 云安全反垃圾云服务视频直播检测结果获取接口地址 */
            String apiUrl = "http://as.dun.163.com/v2/livevideo/callback/results";
            Dictionary<String, String> parameters = new Dictionary<String, String>();

            long curr = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 

DateTimeKind.Utc)).TotalMilliseconds;
            String time = curr.ToString();

            // 1.设置公共参数
            parameters.Add("secretId", secretId);
            parameters.Add("businessId", businessId);
            parameters.Add("version", "v2");
            parameters.Add("timestamp", time);
            parameters.Add("nonce", new Random().Next().ToString());

            // 2.生成签名信息
            String signature = Utils.genSignature(secretKey, parameters);
            parameters.Add("signature", signature);

            // 3.发送HTTP请求
            HttpClient client = Utils.makeHttpClient();
            String result = Utils.doPost(client, apiUrl, parameters, 10000);
            if(result != null)
            {
                JObject ret = JObject.Parse(result);
                int code = ret.GetValue("code").ToObject<Int32>();
                String msg = ret.GetValue("msg").ToObject<String>();
                if (code == 200)
                {
                    JArray array = (JArray)ret.SelectToken("result");
                    foreach (var item in array)
                    {
                        JObject tmp = (JObject)item;
                        String callback = tmp.GetValue("callback").ToObject<String>();
                        JObject evidenceObjec = (JObject)tmp.SelectToken("evidence");
                        JArray labels = (JArray)tmp.SelectToken("labels");
                        if (labels.Count == 0)
                        {
                            Console.WriteLine(String.Format("正常, callback={0}, 证据信息: {1}", callback, 

evidenceObjec.ToString()));
                        }
                        else
                        {
                            foreach (var labelObj in labels)
                            {
                                JObject tmp2 = (JObject)labelObj;
                                int label = tmp2.GetValue("label").ToObject<Int32>();
                                int level = tmp2.GetValue("level").ToObject<Int32>();
                                double rate = tmp2.GetValue("rate").ToObject<Double>();
                                Console.WriteLine(String.Format("异常, callback={0}, 分类:{1}, 证据信息:

{2}", callback, label, evidenceObjec.ToString()));
                            }
                        }
                    }
                }
                else
                {
                    Console.WriteLine(String.Format("ERROR: code={0}, msg={1}", code, msg));
                }
            }
            else
            {
                Console.WriteLine("Request failed!");
            }
        }
    }
}
/**
 * 云安全工具集合,包含:
 * 1:noncer 产生随机整数
 * 2:genSignature 生成Md5签名
 * 3:sendHttpRequest 发送http请求
 */
var utils=(function(){
    var http = require('https');
    var urlutil=require('url');
    var querystring = require('querystring');
    var crypto = require('crypto');
    //产生随机整数--工具方法
    var noncer=function(){
        var range=function(start,end){
            var array=[];
            for(var i=start;i<end;++i){
                array.push(i);
            }
            return array;
        };
        var nonce = range(0,6).map(function(x){
            return Math.floor(Math.random()*10);
        }).join('');
        return nonce;
    };
    //生成签名算法--工具方法
    var genSignature=function(secretKey,paramsJson){
        var sorter=function(paramsJson){
            var sortedJson={};
            var sortedKeys=Object.keys(paramsJson).sort();
            for(var i=0;i<sortedKeys.length;i++){
                sortedJson[sortedKeys[i]] = paramsJson[sortedKeys[i]]
            }
            return sortedJson;
        }
        var sortedParam=sorter(paramsJson);
        var needSignatureStr="";
        for(var key in sortedParam){
            var value=sortedParam[key];
            needSignatureStr=needSignatureStr+key+value;
        }
        needSignatureStr+=secretKey;
        var md5er = crypto.createHash('md5');//MD5加密工具
        md5er.update(needSignatureStr,"UTF-8");
        return md5er.digest('hex');
    };
    //发送post请求
    var sendHttpRequest=function(url,type,data,callback){
        var content = querystring.stringify(data,null,null,null);
        var urlObj=urlutil.parse(url);
        var host=urlObj.hostname;
        var path=urlObj.path;
        var port=urlObj.port;
        var options = {
                hostname: host,
                port: port,
                path: path,
                method: type,
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
                    'Content-Length': Buffer.byteLength(content)
                }
            };
        var responseData="";
        var req = http.request(options, function (res) {
            res.setEncoding('utf8');
            res.on('data', function (chunk) {
                responseData+=chunk;
            });
            res.on('end', function () {
                callback(responseData);
            });
            //设置超时
            req.setTimeout(1000,function(){
                console.log('request timeout!');
                req.abort();
            });
            req.on('error', function (e) {
                console.log('request ERROR: ' + e.message);
            });
        });
        req.write(content);
        req.end();
    };
    return {
        noncer:noncer,
        genSignature:genSignature,
        sendHttpRequest:sendHttpRequest
    }
})();
//产品密钥ID,产品标识
var secretId="your_secret_id";
// 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露
var secretKey="your_secret_key";
// 业务ID,云安全根据产品业务特点分配
var businessId="your_business_id";
// 云安全反垃圾云服务视频直播检测结果获取接口地址
var apiurl="http://as.dun.163.com/v2/livevideo/callback/results";

//请求参数
var post_data = {
    // 1.设置公有有参数
    secretId:secretId,
    businessId:businessId,
    version:"v2",
    timestamp:new Date().getTime(),
    nonce:utils.noncer()
};
var signature=utils.genSignature(secretKey,post_data);
post_data.signature=signature;
//http请求结果
var responseCallback=function(responseData){
    var data = JSON.parse(responseData);
    var code=data.code;
    var msg=data.msg;
    if(code==200){
        var result=data.result;
        if(result.length==0){
            console.log("无数据");
        }else{
            for(var i=0;i<result.length;i++){
                var obj=result[i];
                var callback=obj.callback;
                var evidence=obj.evidence;
                var labelsArray=obj.labels;
                if(labelsArray.length==0){
                    console.log("正常,callback:"+callback+",证据信息:"+JSON.stringify(evidence));
                }else{
                    for(var k=0;k<labelsArray.length;k++){
                        var labelObj=labelsArray[k];
                        var label=labelObj.label;
                        var level=labelObj.level;
                        var rate=labelObj.rate;
                        console.log("异常,callback:"+callback+",分类:"+JSON.stringify(labelObj)+",证据信息

:"+JSON.stringify(evidence));
                    }
                }
            }
        }
    }else{
         console.log('ERROR:code=' + code+',msg='+msg);
    }
}
utils.sendHttpRequest(apiurl,"POST",post_data,responseCallback);
/*
@Author : yidun_dev
@Date : 2020-01-20
@File : livevideo_callback.go
@Version : 1.0
@Golang : 1.13.5
@Doc : http://dun.163.com/api.html
*/
package main

import (
	"crypto/md5"
	"encoding/hex"
	"fmt"
	simplejson "github.com/bitly/go-simplejson"
	"io/ioutil"
	"math/rand"
	"net/http"
	"net/url"
	"sort"
	"strconv"
	"strings"
	"time"
)

const (
	apiUrl     = "http://as.dun.163.com/v2/livevideo/callback/results"
	version    = "v2.1"
	secretId   = "your_secret_id"   //产品密钥ID,产品标识
	secretKey  = "your_secret_key"  //产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露
	businessId = "your_business_id" //业务ID,易盾根据产品业务特点分配
)

//请求易盾接口
func check() *simplejson.Json {
	params := url.Values{}
	params["secretId"] = []string{secretId}
	params["businessId"] = []string{businessId}
	params["version"] = []string{version}
	params["timestamp"] = []string{strconv.FormatInt(time.Now().UnixNano()/1000000, 10)}
	params["nonce"] = []string{strconv.FormatInt(rand.New(rand.NewSource(time.Now().UnixNano())).Int63n(10000000000), 10)}
	params["signature"] = []string{genSignature(params)}

	resp, err := http.Post(apiUrl, "application/x-www-form-urlencoded", strings.NewReader(params.Encode()))

	if err != nil {
		fmt.Println("调用API接口失败:", err)
		return nil
	}

	defer resp.Body.Close()

	contents, _ := ioutil.ReadAll(resp.Body)
	result, _ := simplejson.NewJson(contents)
	return result
}

//生成签名信息
func genSignature(params url.Values) string {
	var paramStr string
	keys := make([]string, 0, len(params))
	for k := range params {
		keys = append(keys, k)
	}
	sort.Strings(keys)
	for _, key := range keys {
		paramStr += key + params[key][0]
	}
	paramStr += secretKey
	md5Reader := md5.New()
	md5Reader.Write([]byte(paramStr))
	return hex.EncodeToString(md5Reader.Sum(nil))
}

func main() {
	ret := check()

	code, _ := ret.Get("code").Int()
	message, _ := ret.Get("msg").String()
	if code == 200 {
		resultArray, _ := ret.Get("result").Array()
		for _, result := range resultArray {
			if resultMap, ok := result.(map[string]interface{}); ok {
				taskId := resultMap["taskId"].(string)
				callback := resultMap["callback"].(string)
				evidence := resultMap["evidence"].(map[string]interface{})
				labelArray := resultMap["labels"].([]interface{})
				if labelArray != nil && len(labelArray) == 0 { //检测正常
					fmt.Printf("正常, taskId: %s, callback: %s, 证据信息: %s", taskId, callback, evidence)
				} else if len(labelArray) > 0 { //检测异常
					//for _, labelItem := range labelArray {
					//	if labelItemMap, ok := labelItem.(map[string]interface{}); ok {
					//		//label, _ := labelItemMap["label"].(json.Number).Int64()
					//		//level, _ := labelItemMap["level"].(json.Number).Int64()
					//		//rate, _ := labelItemMap["rate"].(json.Number).Float64()
					//		fmt.Printf("异常, taskId: %s, callback: %s, 分类: %s, 证据信息: %s", taskId, callback, labelItem, evidence)
					//	}
					//}
				}
			}
		}
	} else {
		fmt.Printf("ERROR: code=%d, msg=%s", code, message)
	}
}

响应示例

输出结果:

{
    "code": 200,
    "msg": "ok",
    "result": [
        {
           "taskId": "b82f6eb1de8d478196a73dd552b73226",  
	        "callback": "40d7e2fba1894512902e92928540a647",
            "evidence": {
                "beginTime": 1469774975520,
                "endTime": 1469774975520,
                "type": 1,
                "url": "http://xxx.nos.netease.com/xxx.jpeg"
            },
            "labels": [
                {
                    "label": 500,
                    "level": 2,
                    "rate": 1,
		                 "subLabels": [{
		               		         "subLabel": 50003,
		               	         	"rate": 1.0,
				                      "details": {
				                    	"hitInfos": ["XXX"]
                             }
                            ]
                 }
        {
            "callback": "40d7e2fba1894512902e92928540a647",
            "evidence": {
                "beginTime": 1469775156321,
                "endTime": 1469775156321,
                "type": 1,
                "url": "http://xxx.nos.netease.com/xxxx.jpeg"
            },
            "labels": [
                
            ]
        }
    ]
}
QQ咨询:反馈更及时 在线咨询 电话咨询:95163223