本文档介绍如何批量新增、删除和查询视频。
视频内容检索有两种批量操作方式,分别为OSS批量操作和数据文件批量操作。视频内容检索与阿里云OSS服务打通,可以通过OSS批量操作功能将OSS中的视频批量导入到视频内容检索中,同时也可以通过OSS批量操作功能实现批量删除已经入库的视频和批量查询相似视频。如果视频并没有存放在OSS中,只有视频URL,则可以使用数据文件批量操作功能,实现视频批量导入、删除和查询操作。
如果您尚未开通OSS服务,请参见开通OSS服务进行开通。开通服务后,您还需要创建存储空间Bucket,具体请参见创建存储空间。
说明
- 开通的OSS为独立计费,具体计费方式请参见计费概述。
- 请确保开通的OSS服务与已购买的视频内容检索服务在同一地域,否则将无法使用批量操作功能。
导入视频具体操作请参见上传文件。
说明 视频存放路径可以自定义,只需要在创建批量任务时设置视频路径即可。
在OSS服务中存放视频的路径下,新建meta文件,该文件用来存储批量任务相关内容。本文示例文件名称为:videosearch.meta
说明 meta文件中涉及的视频必须和meta文件在同一路径下,否则批量操作会失败。
文件参考实例如下:
{"OperationType":"ADD","VideoId":"000bdfbf1cb24215a8fea8b40a493726","VideoName":"电影123.mp4","VideoDesc":"影视剧-体育-新闻", "VideoTags": "movie","CallbackUrl": "www.aliyun.com"}
{"OperationType":"DELETE","VideoId":"000bdfbf1cb24215a8fea8b40a493726","CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频123.mp4","VideoDesc":"短视频相似推荐123","CallbackUrl":"www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频456.mp4","VideoDesc":"短视频查询并入库","VideoId":"10065","StorageType":1,"SearchType":1,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频789.mp4","VideoDesc":"短视频查询并去重入库","VideoId":"10065","VideoTags":"shortVideo","QueryTags":"movie","StorageType":2,"ReplaceStorageThreshold":"0.75","SearchType":1,"ReturnVideoNumber":15,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"人物1.jpg","VideoDesc":"图搜视频-人物1","SearchType":2,"ReturnVideoNumber":15,"CallbackUrl":"www.aliyun.com"}
每个操作由JSON格式表示,具体字段含义如下表所示:
参数 | 类型 | 是否必选 | 说明 |
---|---|---|---|
OperationType | String | 是 | 操作类型。 - ADD:新增视频。 - SEARCH:查询视频。 - DELETE:删除视频。 |
SearchType | Integer | 否 | 检索类型。 - 1:视频搜视频 (默认)。 - 2:图片搜视频。 |
VideoName | String | 是 | 视频或图片文件的名称。OSS的Bucket中的视频或图片文件的名称。OSS批量操作时有效。 说明 - 当OperationType=ADD, SEARCH时,必填。 - 当OperationType=DELETE时,不需要填写。 |
VideoUrl | String | 是 | 视频或者图片的URL,数据文件批量操作时有效。 说明 - 当OperationType=ADD, SEARCH时,必填。 - 当OperationType=DELETE时,不需要填写。 |
VideoDesc | String | 是 | 视频或图片描述 说明 - 当OperationType=Delete时,不需要填写。 |
VideoTags | String | 否 | 视频标签:表示与视频相关的标签信息,会和视频数据一起进行索引,可以与视频一起被搜索,并可用于查询时的条件过滤 |
VideoId | String | 是 | 即业务key,表示视频的唯一id。 说明 - 当OperationType=ADD时,必填。 - 当OperationType=SEARCH并且SearchStorageType=1或2时,必填。 - 当OperationType=DELETE时,不需要填写。 |
QueryTags | String | 否 | 查询条件,与视频标签对应,多个查询条件使用竖线(,)分割。 说明 - 仅当OperationType=SEARCH时有效。 |
StorageType | Integer | 否 | 检索入库类型,仅当SearchType=1时有效。 - 1:直接入库。 - 2:去重入库。 - 3:不入库(默认)。 |
ReplaceStorageThreshold | float | 否 | 去重入库阈值。 - 当StorageType=2(去重入库)时生效,当检索结果中所有视频的置信度都小于该值时,进行数据入库。 - 默认:0.9 |
ReturnVideoNumber | Integer | 否 | 检索结果中返回的最大相似视频数量。 说明 - 默认:20 |
CallbackUrl | String | 否 | 任务结束时的回调url,仅支持http请求 |
视频内容检索服务通过OSS来实现数据批量操作,需要您通过STS(Security Token Service)为视频内容检索服务账号授权。
创建RAM角色。
创建权限策略。
编辑权限策略内容。
选择配置模式为脚本配置。策略内容如下:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"oss:GetObject"
],
"Resource": [
"acs:oss:*:*:${bucket}/${path}/*"
]
}
]
}
${bucket}:表示您在OSS上创建的Bucket。例如videosearch-batchoperation。
设置批量任务参数。
说明 请确保开通的OSS服务与已购买的视频内容检索服务在同一个地域。
数据路径
需要上传的视频和increment.meta文件的存储路径。
说明 路径以/开头,例如/videosearch。
说明 当视频并没有存放在oss中,只有视频URL时,推荐使用数据文件批量操作方式。
该文件用来存储批量任务相关内容。本文示例文件名称为:videosearch.meta
{"OperationType":"ADD","VideoId":"000bdfbf1cb24215a8fea8b40a493726","VideoUrl":"www.aliyun.com/电影123.mp4","VideoDesc":"影视剧-体育-新闻", "VideoTags": "movie","CallbackUrl": "www.aliyun.com"}
{"OperationType":"DELETE","VideoId":"000bdfbf1cb24215a8fea8b40a493726","CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频123.mp4","VideoDesc":"短视频相似推荐123","CallbackUrl":"www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频456.mp4","VideoDesc":"短视频查询并入库","VideoId":"10065","StorageType":1,"SearchType":1,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频789.mp4","VideoDesc":"短视频查询并去重入库","VideoId":"10065","VideoTags":"shortVideo","QueryTags":"movie","StorageType":2,"ReplaceStorageThreshold":"0.75","SearchType":1,"ReturnVideoNumber":15,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/人物1.jpg","VideoDesc":"图搜视频-人物1","SearchType":2,"ReturnVideoNumber":15,"CallbackUrl":"www.aliyun.com"}
在实例详情页,查看所有增量任务的信息。增量任务状态为成功后,用户可以查看相应的提示信息:
在文档使用中是否遇到以下问题
更多建议
匿名提交