创建视频分组后,您可以调用本接口在指定视频分组中添加视频。

描述

业务接口/green/video/dna/add
说明 目前视频指纹检索功能的 endpoint仅支持 cn-shanghai

调用本接口在指定视频分组中增加视频后,接口返回videoId。该参数作为视频的唯一标识,用于视频指纹检索及删除视频等操作中。

该接口为异步接口,提交任务后,您可以调用查询视频添加结果查看视频是否添加成功。

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON对象,字段说明如下:
名称 类型 是否必需 描述
tasks 数组 添加视频任务的任务列表。具体结构见task
表 1. task
名称 类型 是否必需 描述
groupId String 要加入的视频分组的ID。
url String 要添加的视频的URL。
name String 要添加的视频的名称。
note String 要添加的视频的描述信息。

返回参数

返回结果说明,参见返回结果

返回body中的data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code String 错误码,和HTTP的status code一致。
msg String 错误描述信息。
videoId String 系统为该视频生成的唯一标识ID。该ID用于调用视频指纹检索和删除视频等任务中。
taskId String 视频添加任务的ID。使用该ID查询视频添加任务的执行结果。

示例

请求示例
{
    "tasks":[
	   {
	      "groupId":"group1",
		  "url":"http://xxx.xxx.mp4",
		  "name":"示例1",
		  "note":"示例视频"
	   },
	   {
	      "groupId":"group1",
		  "url":"http://xxx.xxx.mp4",
		  "name":"示例2",
		  "note":"示例视频"
	   }
	]
}
返回示例
{
	"msg":"OK",
	"code":200,
	"data":[
		{
			"msg":"Processing - video segment",
			"code":280,
			"videoId":"45044645035792390",
			"taskId":"v_dna_a_id517fdLsDkx36YXmBgw6FbW-1pqSc2"
		},
		{
			"msg":"Processing - video segment",
			"code":280,
			"videoId":"45044645209856007",
			"taskId":"v_dna_a_id3qiJNIgGH3x4NPltDAFbVG-1pqSc2"
		}
	],
	"requestId":"CFBBA3CB-3247-49FA-B5C8-2C8AD3D4358E"
}