视频内容审核

视频内容审核，用于检测视频文件中的不良信息，并给出审核结果管控建议。支持同时检测文件中的音频和视频数据。

1. 功能描述

调用方提交一个或多个审核文件，指定需要检测的类型，服务器异步回调返回检测结果。

画面支持的检测类型及对应标签如下：

声音支持的检测类型和对应标签如下：

2. 使用限制

3. 接口说明

3.1 启动任务

请求接口

请求参数

请求参数存放在请求body中，是一个json对象，具体字段说明如下：

表. 请求data

表. 扩展参数

返回结果

3.2 检测结果回调

回调方式

检测完成后，系统使用HTTP POST方式访问用户提供的callback地址，将检测结果返回给用户。
为了防止内容被篡改，在http请求header增加一个checksum项用于校验内容是否合法。

checksum串的生成方式如下：

启动任务参数携带的sequence + body字符串数据，通过SHA256算法生成checksum值

回调内容

检测结果保存在body中的JSON结构中，具体字段说明如下：

表. 返回data

表. result

result->segment在不同action检测中的结果结构不尽相同，具体包含以下几种情况:

(1)当action为v-porn、v-terrorism、v-antispam、v-sface、v-illegal、v-ad、v-ocr时，result->segment的结构如下:

表. face

表. porn

(2)当action为a-porn时，result->segment的结构如下

(3)当action为a-antispam时，result->segment的结构如下

表. antispam-extraData

3.3 结果同步查询

由于是异步处理，所以建议使用以上的异步回调方式接收处理结果，如有必要可以通过轮训同步接口的方式获取结果，具体说明如下：

请求方式

返回参数

body中的数据是JSON，具体字段说明如下：

4. 调用示例

以下是一个python的调用示例代码：

# -*- coding: utf-8 -*-
#! python3.5

import requests
import uuid
import base64

host = "https://ai.jocloud.com"
appid = 123456789  # 您的业务ID
restful_id = '********************'  # 您的证书ID
restful_secret = '********************'  # 您的证书秘钥
traceid = str(uuid.uuid4())
dataid = str(uuid.uuid4())

# url
url = host + '/app/%s/v1/video/async/submit?traceId=%s' % (appid, traceid)

# headers
headers = {
    "content-type": "application/json"
}

auth = base64.b64encode(("%s:%s" % (restful_id, restful_secret)).encode('utf-8'))
headers['token'] = 'Base ' + auth.decode()

# 需要识别的视频文件url地址
file_url = 'http://newcntv.qcloudcdn.com/asp/hls/1200/0303000a/3/default/d67f1b655f0b49be87fdcc84f7f06029/7.ts'

# 业务放需要使用到的上下文信息，便于在回调消息中协助后续处理，例如：
context = {
    'myid': 123,
    'myname': 'test'
}

# 识别结果及状态的回调地址，识别结果及状态通知将会通过http POST回调
callback_addr = 'http://mydomain.com/callback'

# content
values = {
    'actions': ['v-sface', 'v-porn'],
    'data': [
        {
            'dataId': dataid,
            'dataType': 'URL',
            'content': file_url,
            'extra': {},
            'context': context
        }
    ],
    'callback': callback_addr,
    'sequence': 'test'
}

# request
res = requests.post(url, json=values, headers=headers)
print ('url=%s\nbody=%s\ncode=%s\ndata=%s\n' % (url, values, res.status_code, res.text))

5. 更新历史