文档

ListVideos - 获取多个视频的信息

更新时间:

调用ListVideos接口获取媒体集中的视频信息列表,返回结果以视频加入媒体集的时间升序排序。

接口说明

此接口已不再维护,建议使用新版(2020-09-30 版本)查询与统计相关接口。关于新版与旧版 API 的对比,请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
Projectstring

项目名称。

immvideotest
SetIdstring

媒体集的唯一标识。

videotest
CreateTimeStartstring

视频创建时间的起始点,返回的视频均在此时间后加入媒体集。

2021-01-21T06:40:41.683Z
Markerstring

从 Marker 开始按字典序返回视频信息列表。如果不设置此参数,则从头开始返回视频信息。

CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=

返回参数

名称类型描述示例值
object
RequestIdstring

当次请求的 Request ID。

B1469D0A-862A-405E-B81B-37760516627D
NextMarkerstring

下一次列出视频信息时以此值为 Marker,将未返回的结果返回。

当视频信息未全部返回时,此参数才有值。

CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=
SetIdstring

媒体集的唯一标识。

videoset
Videosobject []

视频信息列表。

CreateTimestring

视频加入媒体集的时间。

2021-01-21T07:40:41.683Z
RemarksCstring

标记信息。

remarkc
VideoTagsFailReasonstring

视频标签处理的失败原因。

Timeout
SourceTypestring

源数据的类型。

video
VideoDurationfloat

视频时长,单位为秒。

15.263
VideoTagsobject []

视频标签处理结果。

TagNamestring

标签名称。

大型超市
TagConfidencefloat

标签置信度。

0.8933850526809692
TagLevelinteger

标签级别,取值范围为 1~4。

2
ParentTagNamestring

父级标签名称。

内部场景
ProcessModifyTimestring

视频处理的更新时间。

2021-01-21T07:40:53.955Z
VideoFramesinteger

帧数。

462
VideoTagsStatusstring

视频标签处理的状态,包括如下选项:

  • NotProcessed:未处理
  • Processing:处理中
  • Success:成功
  • Failed :失败

您可以根据该状态决定读取结果、等待或重试。

Success
ExternalIdstring

外部 ID,用于和您的应用层的 ID(如果有)进行绑定。

externalId001
SourceUristring

视频的 OSS URI。

oss://imm-test/testcases/video.mp4
FileSizeinteger

文件大小,单位为字节。

25115517
ModifyTimestring

视频的修改时间。

添加视频到媒体集后,如果未修改过视频,则视频的修改时间和视频加入媒体集的时间相同。

2021-01-21T07:40:41.683Z
SourcePositionstring

视频中该图片帧处于源视频的时间轴位置。格式为 00000000.010,即%8.3f。

00000000.010
VideoWidthinteger

视频画面的宽度。

1080
VideoFormatstring

视频格式。

mov,mp4,m4a,3gp,3g2,mj2
VideoHeightinteger

视频画面的高度。

1920
RemarksDstring

标记信息。

remarkd
VideoUristring

视频的 OSS URI。

oss://imm-test/testcases/video.mp4
ProcessFailReasonstring

视频处理的失败原因。

Timeout
VideoTagsModifyTimestring

视频标签处理的更新时间。当 VideoTagsStatus 更改时更新。

2021-01-21T07:40:53.95Z
RemarksAstring

标记信息。

AdminGroup/AdminUserA/
ProcessStatusstring

视频处理的状态。

Success
RemarksBstring

标记信息。

nas://path/to/file

示例

正常返回示例

JSON格式

{
  "RequestId": "B1469D0A-862A-405E-B81B-37760516627D",
  "NextMarker": "CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=",
  "SetId": "videoset",
  "Videos": [
    {
      "CreateTime": "2021-01-21T07:40:41.683Z",
      "RemarksC": "remarkc",
      "VideoTagsFailReason": "Timeout",
      "SourceType": "video",
      "VideoDuration": 15.263,
      "VideoTags": [
        {
          "TagName": "大型超市",
          "TagConfidence": 0.8933850526809692,
          "TagLevel": 2,
          "ParentTagName": "内部场景"
        }
      ],
      "ProcessModifyTime": "2021-01-21T07:40:53.955Z",
      "VideoFrames": 462,
      "VideoTagsStatus": "Success",
      "ExternalId": "externalId001",
      "SourceUri": "oss://imm-test/testcases/video.mp4",
      "FileSize": 25115517,
      "ModifyTime": "2021-01-21T07:40:41.683Z",
      "SourcePosition": "00000000.010",
      "VideoWidth": 1080,
      "VideoFormat": "mov,mp4,m4a,3gp,3g2,mj2",
      "VideoHeight": 1920,
      "RemarksD": "remarkd",
      "VideoUri": "oss://imm-test/testcases/video.mp4",
      "ProcessFailReason": "Timeout",
      "VideoTagsModifyTime": "2021-01-21T07:40:53.95Z",
      "RemarksA": "AdminGroup/AdminUserA/",
      "ProcessStatus": "Success",
      "RemarksB": "nas://path/to/file"
    }
  ]
}

错误码

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

  • 本页导读 (1)
文档反馈