AI 助理
文档备案控制台
官方文档
首页 智能媒体服务 开发参考 API参考 API目录 媒资管理 媒资库 BatchGetMediaInfos - 批量获取媒体信息

BatchGetMediaInfos - 批量获取媒体信息

更新时间：
复制 MD 格式
产品详情
我的收藏

批量获取媒资信息，支持传入多个mediaId。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:BatchGetMediaInfos

get

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
MediaIds

string

否

所有待查询的媒资 ID，以逗号分隔。

******b48fb04483915d4f2cd8******,******c48fb37407365d4f2cd8******
AdditionType

string

否

批量查询的媒资额外信息，默认只返回 BasicInfo，额外文件信息内容包括：

-FileInfo

-DynamicMetaData

FileInfo,DynamicMetaData
AuthTimeout

integer

否

鉴权过期时间，单位：秒。

  • 最小值：1。

  • 最大值：86400。

  • 默认值：3600。

30

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

******11-DB8D-4A9A-875B-275798******
MediaInfos

array<object>

符合要求的媒资集合。

array<object>

符合要求的媒资集合。

MediaId

string

媒资 ID。

******c48fb37407365d4f2cd8******
MediaBasicInfo

object

媒资基础信息。

MediaId

string

媒资 ID。

******c48fb37407365d4f2cd8******
InputURL

string

待注册的媒资在相应系统中的地址。

https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType

string

媒资媒体类型。取值为：

  • Image。

  • Video。

  • Audio。

  • Text。

video
BusinessType

string

媒资业务类型。

general
Source

string

来源。取值为：

  • OSS。

  • vod。

oss
Title

string

标题。

title
Description

string

内容描述。

description
Category

string

分类。

category1
MediaTags

string

标签。

tag1, tag2
CoverURL

string

封面地址。

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData

string

用户数据。

userDataTest
Snapshots

string

截图。

[ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
Status

string

资源状态。

Normal
TranscodeStatus

string

转码状态。

Init
CreateTime

string

媒资创建时间。时间格式为 ISO 8601，使用 UTC 时间（以 Z 结尾）。

2020-12-26T04:11:10Z
ModifiedTime

string

媒资修改时间。时间格式为 ISO 8601，使用 UTC 时间（以 Z 结尾）。

2020-12-26T04:11:12Z
DeletedTime

string

媒资删除时间。时间格式为 ISO 8601，使用 UTC 时间（以 Z 结尾）。

2020-12-26T04:11:10Z
SpriteImages

string

雪碧图。

[{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]
Biz

string

媒资所属业务。

ICE
FileInfoList

array<object>

文件基础信息列表。

array<object>

文件基础信息。

FileBasicInfo

object

文件基础信息，包含时长，大小等。

FileName

string

文件名。

example
FileStatus

string

文件状态。

Normal
FileType

string

文件类型。

source_file
FileSize

string

文件大小（字节）。

30611502
FileUrl

string

文件 OSS 地址。

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region

string

文件存储区域。

cn-shanghai
FormatName

string

封装格式。

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

string

时长。

200
Bitrate

string

码率。

1132.68
Width

string

宽。

1920
Height

string

高。

1080
AudioStreamInfoList

array<object>

音频流信息，一个媒资可能有多条音频流

object

Index

string

音频流序号

1
CodecName

string

编码格式简述名

aac
CodecLongName

string

编码格式长述名

AAC (Advanced Audio Coding)
CodecTimeBase

string

编码时基

1/24000
CodecTagString

string

编码格式标记文本

mp4a
CodecTag

string

编码格式标记

0x6134706d
Profile

string

编码预置

High
SampleFmt

string

采样格式

fltp
SampleRate

string

采样率

44100
Channels

string

声道数

2
ChannelLayout

string

声道输出样式

stereo
Timebase

string

时基

1/44100
StartTime

string

起始时间，单位：秒。

0.000000
Duration

string

时长

16.200998
Bitrate

string

码率

127.794
Fps

string

音频帧率

8
NumFrames

string

总帧数

10
Lang

string

语言

und
VideoStreamInfoList

array<object>

视频流信息，一个媒资可能有多条视频流

object

Index

string

视频流序号

0
CodecName

string

编码格式简述名

h264
CodecLongName

string

编码格式长述名

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile

string

编码预置

High
CodecTimeBase

string

编码时基

1/48
CodecTagString

string

编码格式标记文本

[0][0][0][0]
CodecTag

string

编码格式标记

0x0000
Width

string

宽

960
Height

string

高

540
HasBFrames

string

是否有 B 帧

2
Sar

string

编码信号分辨率比

0:1
Dar

string

编码显示分辨率比

0:1
PixFmt

string

像素格式

yuv420p
Level

string

编码等级

30
Fps

string

视频帧率

24.0
AvgFPS

string

平均帧率

24.0
Timebase

string

时基

1/12288
StartTime

string

起始时间，单位：秒。

0.081706
Duration

string

时长

216.206706
Bitrate

string

码率

1001.594
NumFrames

string

总帧数

5184
Lang

string

语言

und
Rotate

string

旋转

0
Nb_frames

string

总帧数

5184
SubtitleStreamInfoList

array<object>

字幕流信息，一个媒资可能有多条字幕流

object

Index

string

音频流序号

1
CodecName

string

编码格式简述名

srt
CodecLongName

string

编码格式长述名

SubRip Text
CodecTimeBase

string

编码时基

29.97
CodecTagString

string

编码格式标记文本

unicode
CodecTag

string

编码格式标记

unicode
Timebase

string

时基

30
StartTime

string

起始时间，单位：秒。

0
Duration

string

时长

1
Lang

string

语言

und
MediaDynamicInfo

object

媒资类型。

DynamicMetaData

object

类型。取值范围：

  • "ai": AI 原始结果统一化处理后的 AI 数据

  • "user-defined": 用户自定义元数据

  • "system": 系统自带

Data

string

媒资类型。

system
IgnoredList

array

获取失败的媒资信息列表。

string

媒资信息。

****20b48fb04483915d4f2cd8ac****

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/24000",
              "CodecTagString": "mp4a",
              "CodecTag": "0x6134706d",
              "Profile": "High",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/44100",
              "StartTime": "0.000000",
              "Duration": "16.200998",
              "Bitrate": "127.794",
              "Fps": "8",
              "NumFrames": "10",
              "Lang": "und"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "CodecName": "h264",
              "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "CodecTimeBase": "1/48",
              "CodecTagString": "[0][0][0][0]",
              "CodecTag": "0x0000",
              "Width": "960",
              "Height": "540",
              "HasBFrames": "2",
              "Sar": "0:1",
              "Dar": "0:1",
              "PixFmt": "yuv420p",
              "Level": "30",
              "Fps": "24.0",
              "AvgFPS": "24.0",
              "Timebase": "1/12288",
              "StartTime": "0.081706",
              "Duration": "216.206706",
              "Bitrate": "1001.594",
              "NumFrames": "5184",
              "Lang": "und",
              "Rotate": "0",
              "Nb_frames": "5184"
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "srt",
              "CodecLongName": "SubRip Text",
              "CodecTimeBase": "29.97",
              "CodecTagString": "unicode",
              "CodecTag": "unicode",
              "Timebase": "30",
              "StartTime": "0",
              "Duration": "1",
              "Lang": "und"
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：DeleteMediaInfos - 删除媒资内容下一篇：ListMediaBasicInfos - 列出媒资基础信息