首页 智能媒体管理 旧版API参考（2017-09-06） API目录 视频管理 媒体集视频处理 GetVideo - 获取一个视频的信息

GetVideo - 获取一个视频的信息

调用GetVideo获取媒体集中一个视频的信息。

调试

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

调试

授权信息

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

请求参数

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

项目名称。

immvideotest
SetIdstring是

媒体集的唯一标识。

videoset
VideoUristring是

视频的OSS URI。

OSS地址规则为oss://bucket/object，其中bucket为和当前项目处于同一区域的OSS Bucket名称，object为文件路径。

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

返回参数

名称类型描述示例值
object
VideoSTTStatusstring

语音转文字的状态。

Success
VideoFacesStatusstring

视频人脸识别的状态。

Success
RemarksCstring

标记信息。

remarkc
CreateTimestring

视频加入媒体集的时间。

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

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

Timeout
SourceTypestring

源数据的类型。

video
VideoDurationnumber

视频时长，单位为秒。

15.263
ProcessModifyTimestring

视频处理的更新时间。

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

帧数。

462
RequestIdstring

当次请求的Request ID。

5FC2B195-B43E-45ED-9BEC-169358550193
VideoTagsStatusstring

视频标签处理的状态，包括如下选项：

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

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

Success
SetIdstring

媒体集的唯一标识。

videoset
VideoOCRStatusstring

OCR识别的状态。

Success
VideoFacesFailReasonstring

视频人脸识别的失败原因。

Timeout
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
VideoOCRModifyTimestring

OCR识别的更新时间。

1970-01-01T00:00:00Z
VideoSTTModifyTimestring

语音转文字的更新时间。

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

视频画面的宽度。

1080
VideoFrameTagsFailReasonstring

视频帧标签识别的失败原因。

Timeout
VideoFormatstring

视频格式。

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

视频画面的高度。

1920
VideoSTTFailReasonstring

语音转文字的失败原因。

Timeout
VideoFrameTagsStatusstring

视频帧标签识别的状态。

Success
VideoInfostring

视频信息。

{"MediaStreams":{"VideoStreams":[{"Index":0,"Language":"eng","CodecName":"h264","CodecLongName":"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10","Profile":"Baseline","CodecTimeBase":"1373627/83160000","CodecTagString":"avc1","CodecTag":"0x31637661","Width":1080,"Height":1920,"SampleAspectRatio":"1:1","DisplayAspectRatio":"9:16","PixelFormat":"yuv420p","Level":40,"FrameRrate":"90000/1","AverageFrameRate":"41580000/1373627","TimeBase":"1/90000","StartTime":"0.000000","Duration":"15.262522","Bitrate":"13091201","Frames":"462"}],"AudioStreams":[],"SubtitleStreams":[]},"MediaFormat":{"NumberStreams":2,"FormatName":"mov,mp4,m4a,3gp,3g2,mj2","FormatLongName":"QuickTime / MOV","Size":"25115517","Duration":"15.263000","StartTime":"0.000000","Bitrate":"13164131","CreationTime":"2020-10-25T09:16:09.000000Z","Address":{},"Tag":{}}}
VideoFrameTagsModifyTimestring

视频帧标签识别的更新时间。

1970-01-01T00:00:00Z
RemarksDstring

标记信息。

remarkd
ProcessFailReasonstring

视频处理的失败原因。

Timeout
VideoTagsModifyTimestring

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

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

视频的OSS URI。

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

标记信息。

AdminGroup/AdminUserA/
VideoFacesModifyTimestring

视频人脸识别的更新时间。

1970-01-01T00:00:00Z
VideoOCRFailReasonstring

OCR识别的失败原因。

Timeout
ProcessStatusstring

视频处理的状态。

Success
RemarksBstring

标记信息。

nas://path/to/file
VideoTagsarray

视频标签处理结果。

object
TagLevelinteger

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

2
ParentTagNamestring

父级标签名称。

内部场景
TagNamestring

标签名称。

大型超市
TagConfidencenumber

标签置信度。

0.8933850526809692

示例

正常返回示例

JSON格式

{
  "VideoSTTStatus": "Success",
  "VideoFacesStatus": "Success",
  "RemarksC": "remarkc",
  "CreateTime": "2021-01-21T07:40:41.683Z",
  "VideoTagsFailReason": "Timeout",
  "SourceType": "video",
  "VideoDuration": 15.263,
  "ProcessModifyTime": "2021-01-21T07:40:53.955Z",
  "VideoFrames": 462,
  "RequestId": "5FC2B195-B43E-45ED-9BEC-169358550193",
  "VideoTagsStatus": "Success",
  "SetId": "videoset",
  "VideoOCRStatus": "Success",
  "VideoFacesFailReason": "Timeout",
  "ExternalId": "externalId001",
  "SourceUri": "oss://imm-test/testcases/video.mp4",
  "FileSize": 25115517,
  "ModifyTime": "2021-01-21T07:40:41.683Z",
  "SourcePosition": "00000000.010",
  "VideoOCRModifyTime": "1970-01-01T00:00:00Z",
  "VideoSTTModifyTime": "2021-01-21T07:40:53.95Z",
  "VideoWidth": 1080,
  "VideoFrameTagsFailReason": "Timeout",
  "VideoFormat": "mov,mp4,m4a,3gp,3g2,mj2",
  "VideoHeight": 1920,
  "VideoSTTFailReason": "Timeout",
  "VideoFrameTagsStatus": "Success",
  "VideoInfo": "{\"MediaStreams\":{\"VideoStreams\":[{\"Index\":0,\"Language\":\"eng\",\"CodecName\":\"h264\",\"CodecLongName\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"Profile\":\"Baseline\",\"CodecTimeBase\":\"1373627/83160000\",\"CodecTagString\":\"avc1\",\"CodecTag\":\"0x31637661\",\"Width\":1080,\"Height\":1920,\"SampleAspectRatio\":\"1:1\",\"DisplayAspectRatio\":\"9:16\",\"PixelFormat\":\"yuv420p\",\"Level\":40,\"FrameRrate\":\"90000/1\",\"AverageFrameRate\":\"41580000/1373627\",\"TimeBase\":\"1/90000\",\"StartTime\":\"0.000000\",\"Duration\":\"15.262522\",\"Bitrate\":\"13091201\",\"Frames\":\"462\"}],\"AudioStreams\":[],\"SubtitleStreams\":[]},\"MediaFormat\":{\"NumberStreams\":2,\"FormatName\":\"mov,mp4,m4a,3gp,3g2,mj2\",\"FormatLongName\":\"QuickTime / MOV\",\"Size\":\"25115517\",\"Duration\":\"15.263000\",\"StartTime\":\"0.000000\",\"Bitrate\":\"13164131\",\"CreationTime\":\"2020-10-25T09:16:09.000000Z\",\"Address\":{},\"Tag\":{}}}",
  "VideoFrameTagsModifyTime": "1970-01-01T00:00:00Z",
  "RemarksD": "remarkd",
  "ProcessFailReason": "Timeout",
  "VideoTagsModifyTime": "2021-01-21T07:40:53.95Z",
  "VideoUri": "oss://imm-test/testcases/video.mp4",
  "RemarksA": "AdminGroup/AdminUserA/",
  "VideoFacesModifyTime": "1970-01-01T00:00:00Z",
  "VideoOCRFailReason": "Timeout",
  "ProcessStatus": "Success",
  "RemarksB": "nas://path/to/file",
  "VideoTags": [
    {
      "TagLevel": 2,
      "ParentTagName": "内部场景",
      "TagName": "大型超市",
      "TagConfidence": 0.8933850526809692
    }
  ]
}

错误码

访问错误中心查看更多错误码。
阿里云首页 智能媒体管理 相关技术圈