## 接口地址

http://as.dun.163.com/v3/video/submit (http://as.dun.163.com/v3/video/submit)

## 接口描述

提交点播视频相关信息接口，信息提交后，易盾会根据客户自己设置的截图频率对点播视频进行截图检测，检测结果需产品自行定期调用视频结果获取 (/documents/2018041903?docId=150440859531399168)接口获取。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

查看v3.1提交接口文档 (/help/documents/536325108029534208)

## 支持格式

检测接口支持的视频封装格式：flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等。

## 大小限制

视频大小限制：<5G。

## 请求参数

公共参数已省略，详细见 请求公共参数 (/help/documents/150439172888514560)

### 基本参数
参数名称 | 类型 | 是否必选 | 最大长度 | 描述
url | String | Y | 512 | 点播视频地址
dataId | String | Y | 128 | 点播视频唯一标识
version | String | Y | 4 | 接口版本号，可选值 v3.2
title | String | N | 512 | 视频名称
callback | String | N | 512 | 数据回调参数，产品根据业务情况自行设计，当获取离线检测结果时，易盾内容安全服务会返回该字段
callbackUrl | String | N | 256 | 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。
uniqueKey | String | N | 64 | 客户个性化视频唯一性标识，传入后，将以此值作为重复检测依据，若不传，默认以URL作为查重依据,如果重复提交会被拒绝，返回报错信息请求重复，以及原提交taskID值，具体返回请查看响应示例
subProduct | String | N | 32 | 业务结算id(自定义),业务方传入参数，用于资源账单统计,如需开启请联系易盾客户经理。开启之后资源账单按套餐结算sheet增加subProduct维度的数据请求量、检测量、消耗金额的统计

### 业务扩展参数

业务扩展参数，有助于通过业务维度辅助反垃圾结果判定

参数名称 | 类型 | 是否必选 | 最大长度 | 描述
用户信息 | - | N | - | 用户信息包含账号、昵称、等级、角色等，请查看 业务扩展参数—用户信息
设备信息 | - | N | - | 设备信息包含设备ID、设备ID类型等，请查看 业务扩展参数—设备信息
场景信息 | - | N | - | 场景信息包含私聊、群聊、直播、帖子等场景字段，请查看 业务扩展参数—场景信息
ip | String | N | 128 | 用户 IP 地址
extension | String | N | 30000 | 自定义扩展参数

### 截帧频率指定
参数名称 | 类型 | 是否必选 | 最大长度 | 描述
scFrequency | Number | N | 4 | 默认截帧设置，默认5秒截图检测一次，可设置范围为0.5~600秒
advancedFrequency | json字符串 | N | 128 | 高级截帧设置，此项填写，默认截帧策略失效

advancedFrequency字符串数据结构

参数名称 | 类型 | 是否必选 | 最大长度 | 描述
durationPoints | 数组 | Y | 5 | 视频时长区间分割，单位为秒
frequencies | 数组 | Y | 6 | 视频时长区间对应的截帧频率，可设置范围为0.5~600秒

[md-attention]
#### 高级截帧配置说明

◆ 高级截帧配置适用于需要根据视频时长，设定不同截帧频率的场景，例如您需将5分钟以内的视频按照1s/帧截图，5分钟-10分钟的视频按照5s/帧截图，大于10分钟的视频按照10s/帧截图，advancedFrequency字符串应传入：

{

"durationPoints":[300,600],

"frequencies":[1,5,10]

}

◆ 高级截帧频率配置后，默认截帧频率即失效

## 响应结果

响应字段如下，响应通用字段已省略，详细见 响应通用字段 (/help/documents/150439250088873984) ：

参数名称 | 类型 | 描述
taskId | String | 本次请求数据标识，可以根据该标识查询数据最新结果
status | Number | 检测结果，0：成功，1：失败
dealingCount | Number | 缓冲池排队待处理数据量

[md-attention]
#### 缓冲池排队待处理量说明

为减少用户重试，优化用户体验，易盾为点播视频用户提供了缓冲池功能，点播视频正式的并发处理为30路，提交超并发后即自动进入缓冲池排队过检，您可以根据缓冲池排队积压量评估您目前的并发处理速度是否合适，如需调整处理并发请联系您的专属商务处理。

## 响应示例

输出结果：

Code (json):
{
    "code":200,
    "msg":"ok",
    "result":{
        "taskId":"f67fee0890de4c118d4f672b7c8ee304",
        "status":0,
        "dealingCount":1
    }
}

重复检测返回结构

1.uniqueKey提交重复

2.如果不传uniqueKey默认以url做判断，如若当前有正在检测的url,重复检测按照失败返回

Code (json):
{
    "code":417,
    "msg":"返回原提交taskID值"
 }