## 接口地址
[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 | - | 用户信息包含账号、昵称、等级、角色等，请查看 <a href="https://support.dun.163.com/documents/2018041901?locale=zh-cn&docId=476559002902757376" target="black">业务扩展参数—用户信息</a>|
| 设备信息| - | N | - | 设备信息包含设备ID、设备ID类型等，请查看 <a href="https://support.dun.163.com/documents/2018041901?locale=zh-cn&docId=476559002902757376" target="black">业务扩展参数—设备信息</a> |
| 场景信息| - | N | - | 场景信息包含私聊、群聊、直播、帖子等场景字段，请查看 <a href="https://support.dun.163.com/documents/2018041901?locale=zh-cn&docId=476559002902757376" target="black">业务扩展参数—场景信息</a>  |
| 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]

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

</md-attention>


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

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

<md-attention>
		
#### 缓冲池排队待处理量说明

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



## 响应示例
输出结果：

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

重复检测返回结构

1.uniqueKey提交重复

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

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

```