视频鉴暴恐提供视频内容检测，识别视频中是否存在暴恐内容。

• 支持存储在七牛云 bucket（支持华东、华北和华南 bucket）或 非七牛云 bucket 中的视频进行视频鉴暴恐。
• 支持实时处理和异步处理两种方式：实时处理时，视频鉴暴恐结果会在识别完成后立即返回；异步处理时，会立即返回job_id，视频鉴暴恐结果通过job_id获得。
• 视频鉴暴恐结果会返回所有视频片段是属于暴恐、或正常的识别结果。同时为了让用户知道一个视频整体的分类，返回的结果会包含视频片段中出现过的分类，并显示属于这个分类的视频片段的最高的置信度。
• 可以通过设置请求参数，仅返回满足客户需求的视频片段（例如：用户仅需要返回包含暴恐的视频片段，以便对这部分内容做人工审核）。
• 支持一次调用同时请求鉴黄、鉴暴恐、敏感人物识别。请查看视频鉴黄文档中三鉴（鉴黄、鉴暴恐和敏感人物识别）同时调用的示例。

视频片段segments：视频鉴黄是把视频截帧后，对截帧图片进行鉴黄。当连续帧推理结果一致时，表示这些帧都属于同一种类型，则把这一时段的视频认为是一个视频片段。

请求语法

POST /v1/video/<vid>
Host: ai.qiniuapi.com
Content-Type: application/json
Authorization: Qiniu <AccessKey>:<Sign>

{
    "data": {
        "uri": "http://www.qiniu.com/video.mp4"
    },
    "params": {
        "async": <async:bool>,
        "vframe": {
            "mode": <mode:int>,
            "interval": <interval:float>
        },
        "save": {
            "bucket": <bucket:string>,
            "prefix": <prefix:string>
        },
        "hookURL": "http://yy.com/yyy"
    },
    "ops": [
        {
            "op": <op:string>,
            "params": {
                "other": {
                    "detail": <bool>
                },
                "labels": [
                    {
                        "label": <label:string>,
                        "select": <select:int>,
                        "score": <score:float>
                    },
                    ...
                ]
            }
        },
        ... 
    ]
}

注意： 需要在 POST 请求的 head 部分添加七牛鉴权，以进行用户身份验证。

响应语法

返回结果按照请求参数params.async分为两种：

• params.async == false：实时处理请求，视频鉴暴恐完成后就返回结果

HTTP/1.1 200 OK
Content-Type: application/json

{
    <op:string>: {
        "labels": [
            {
                "label": <label:string>,
                "score": <score:float>
            },
            ...
        ],
        "segments": [
            {
                "offset_begin": <offset:int>,
                "offset_end": <offset:int>,
                "labels": [
                    {
                        "label": <label:string>,
                        "score": <score:float>
                    },
                    ...
                ],
                "cuts": [
                    {
                        "offset": <offset:int>,
                        "uri": <uri:string>,
                        "result": {
                            "label": <label:string>,
                            "class": <class:string>,
                            "score": <score:float>,
                            "review": <review:bool>
                        }
                    },
                    ...
                ]
            },
            ...
        ]
    }
}

• params.async == true：异步处理请求，立即返回job_id

HTTP/1.1 200 OK
Content-Type: application/json

{
    "job": <job_id>
}

异步处理的结果

• 异步处理后，获取单个视频鉴暴恐的结果

请求语法

GET /v1/jobs/video/<job-id> HTTP/1.1
Host: ai.qiniuapi.com
Authorization: Qiniu <AccessKey>:<Sign>

注意： 需要在请求的 head 部分添加七牛鉴权，以进行用户身份验证。

响应语法

{
    "id": <job_id:string>,
    "vid": <string>,
    "request": {},
    "status": <string>,
    "result": {
        <op>: {
        },
        ...
    },
    "error": <string>,
    "created_at": <string>,
    "updated_at": <string>
}

错误代码含义

• 异步处理时，获取视频处理任务状态

请求语法

GET /v1/jobs/video?status=<string> HTTP/1.1
Host: ai.qiniuapi.com
Authorization: Qiniu <AccessKey>:<Sign>

注意： 需要在请求的 head 部分添加七牛鉴权，以进行用户身份验证。

响应语法

[
    {
        "id": <string>,
        "status": <string>,
        "created_at": <string>,
        "updated_at": <string>
    },
    ...
]

视频处理的结果回调

• 所有op处理结束后的结果回调CALLBACK /v1/video/result

请求语法

POST /xxxxx HTTP/1.1
Content-Type: application/json

{
    "id": <vid:string>,
    "result": {
        <op>: {
        },
        ...
    }
}

请求示例

{
    "data": {
        "uri": "http://foo.com/foo.mp4"
    },
    "params": {
        "vframe": {
            "interval": 5
        }
    },
    "ops": [
        {
            "op": "terror",
            "params": {
                "labels": [
                    {
                        "label": "0"
                    }
                ]
            }
        }
    ]
}

{
    "terror": {
        "labels": [
            {
                "label": "0",
                "score": 0.9996557
            }
        ],
        "segments": [
            {
                "cuts": [
                    {
                        "offset": 0,
                        "result": {
                            "label": "0",
                                                        "class": normal,
                            "review": false,
                            "score": 0.9996557
                        }
                    },
                    ...
                ],
                "labels": [
                    {
                        "label": "0",
                        "score": 0.9996557
                    }
                ],
                "offset_begin": 0,
                "offset_end": 0
            }
        ]
    }
}

价格

视频鉴暴恐的工作流程如下：
1）按照API里面的设置对视频进行截帧，截帧不额外收费
2）对截帧进行图片鉴暴恐
所以，视频鉴暴恐的价格最终还是图片鉴暴恐的价格，具体价格请参考。

服务价格

视频鉴暴恐是对视频截帧后，对截帧进行图片鉴暴恐，所以视频鉴暴恐价格实际使用的是截帧图片鉴暴恐的价格，与图片鉴暴恐共用范围。

例：
某月视频文件使用视频鉴暴恐服务，视频截帧的数量为400万，即视频鉴暴恐产生的图片鉴暴恐量为400万；当月图片文件使用鉴暴恐服务，其调用量为106万。则这个月总的图片鉴暴恐调用量为506万，账单金额则为:
图片鉴暴恐：

3000000*0.155/100+2000000*0.145/100=4650+2900＝7550元