调用IndexVideo对视频进行自动截帧、分组、识别_智能媒体管理-阿里云帮助中心

调用IndexVideo接口将视频添加到媒体集中，并对视频进行自动截帧、分组、识别等操作。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Project	string	是	项目名称。	immvideotest
SetId	string	是	媒体集的唯一标识。	videotest
VideoUri	string	是	视频的OSS URI。 OSS地址规则为`oss://bucket/object`，其中bucket为和当前项目处于同一区域的OSS Bucket名称，object为文件路径。	oss://imm-test/testcases/video.mp4
RemarksA	string	否	标记信息，为使用者预留的筛选参数，用于记录所需要的信息。在搜索等场景下，您可以以前缀匹配的方式将设置的值作为搜索条件，样例场景如下：作为客户端权限字段存入，例如AdminGroup/AdminUserA/，即可使用前缀过滤用户权限。作为客户端的相对路径存入，例如nas://path/to/file。	AdminGroup/AdminUserA/
RemarksB	string	否	标记信息，为使用者预留的筛选参数，用于记录所需要的信息。在搜索等场景下，您可以以前缀匹配的方式将设置的值作为搜索条件，样例场景如下：作为客户端权限字段存入，例如AdminGroup/AdminUserA/，即可使用前缀过滤用户权限。作为客户端的相对路径存入，例如nas://path/to/file。	nas://path/to/file
TgtUri	string	否	存储数据的OSS地址。不支持此参数。	oss://imm-test/testcases
RemarksC	string	是	标记信息，为使用者预留的筛选参数，用于记录所需要的信息。在搜索等场景下，您可以以前缀匹配的方式将设置的值作为搜索条件，样例场景如下：作为客户端权限字段存入，例如AdminGroup/AdminUserA/，即可使用前缀过滤用户权限。作为客户端的相对路径存入，例如nas://path/to/file。	remarkc
RemarksD	string	否	标记信息，为使用者预留的筛选参数，用于记录所需要的信息。在搜索等场景下，您可以以前缀匹配的方式将设置的值作为搜索条件，样例场景如下：作为客户端权限字段存入，例如AdminGroup/AdminUserA/，即可使用前缀过滤用户权限。作为客户端的相对路径存入，例如nas://path/to/file。	remarkd
ExternalId	string	否	外部ID，用于和您的应用层的ID（如果有）进行绑定。	externalId001
NotifyTopicName	string	否	异步反向通知的TopicName。	topic2
NotifyEndpoint	string	否	异步反向通知的Endpoint，视频处理结果可以通过该Endpoint异步通知给调用者。使用此功能需要先开通MNS服务，新建topic和queue，并配置订阅关系。具体操作，请参见消息服务MNS快速入门概述。说明MNS服务和智能媒体管理必须处于同一地域。	http://1111111111.mns.cn-hangzhou.aliyuncs.com

返回参数

名称	类型	描述	示例值
	object
ModifyTime	string	视频的修改时间。添加视频后，如果未修改过视频，则视频的修改时间和视频加入媒体集的时间相同。	2021-01-21T07:40:41.683Z
RequestId	string	当次请求的Request ID。	896ABAD1-C452-4BED-B5E0-302955F8BAB5
CreateTime	string	视频加入媒体集的时间。	2021-01-21T07:40:41.683Z
ExternalId	string	外部ID，用于和您的应用层的ID（如果有）进行绑定。	externalId001
VideoUri	string	视频的OSS URI。	oss://imm-test/testcases/video.mp4
RemarksA	string	标记信息。如果请求时未设置此参数，则返回值为空。	AdminGroup/AdminUserA/
RemarksB	string	标记信息。如果请求时未设置此参数，则返回值为空。	nas://path/to/file
RemarksC	string	标记信息。如果请求时未设置此参数，则返回值为空。	remarkc
RemarksD	string	标记信息。如果请求时未设置此参数，则返回值为空。	remarkd
SetId	string	媒体集的唯一标识。	videoset

示例

正常返回示例

JSON格式

{
  "ModifyTime": "2021-01-21T07:40:41.683Z",
  "RequestId": "896ABAD1-C452-4BED-B5E0-302955F8BAB5",
  "CreateTime": "2021-01-21T07:40:41.683Z",
  "ExternalId": "externalId001",
  "VideoUri": "oss://imm-test/testcases/video.mp4",
  "RemarksA": "AdminGroup/AdminUserA/",
  "RemarksB": "nas://path/to/file",
  "RemarksC": "remarkc",
  "RemarksD": "remarkd",
  "SetId": "videoset"
}

错误码

访问错误中心查看更多错误码。