GetYikeAssetMediaInfo - 获取媒资信息详情

更新时间:
复制为 MD 格式

获取媒资内容信息。

调试

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

调试

授权信息

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

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

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ice:GetYikeAssetMediaInfo

get

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

MediaId

string

媒资 ID。

****20b48fb04483915d4f2cd8ac****

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

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

MediaInfo

object

媒资信息。

MediaId

string

媒资 ID。

****20b48fb04483915d4f2cd8ac****

MediaBasicInfo

object

媒资基础信息。

MediaId

string

媒资 ID。

****20b48fb04483915d4f2cd8ac****

InputURL

string

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

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

MediaType

string

媒资媒体类型。

video

BusinessType

string

媒资业务类型。

general

Source

string

来源。

oss

Title

string

标题。

v6l82k_176822379****.jpeg

Description

string

内容描述。

description

Category

string

分类。

category

MediaTags

string

标签。

tag1

CoverURL

string

封面地址。

https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/01e1271d-ff4f-4689-9c20-e1df81486859_open_live_cover.jpg

UserData

string

用户数据。

UserData

Snapshots

string

截图。

[]

Status

string

资源状态。

Normal

CreateTime

string

媒资创建时间。

2020-12-26T04:11:08Z

ModifiedTime

string

媒资修改时间。

2020-12-26T04:11:10Z

DeletedTime

string

媒资删除时间。

2020-12-26T04:11:15Z

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"}]

CateId

integer

分类 ID。

3048

Biz

string

媒资所属业务。

AiSaas

UploadSource

string

媒资上传来源

general

CateName

string

分类名称。

cateName

ReferenceId

string

自定义 ID,仅支持小写字母、大写字母、数字、横线、下划线,长度 6-64 位。用户维度唯一。

123-1234

ThumbURL240P

string

高度为 240 像素的缩略图。

ThumbURL240P

ThumbURLWebp

string

采用 WebP 格式编码的缩略图‌。

ThumbURLWebp

FileInfoList

array<object>

文件信息。

array<object>

文件信息。

FileBasicInfo

object

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

FileName

string

文件名。

example.mp4

FileStatus

string

文件状态。

Normal

FileType

string

文件类型。

source_file

FileSize

string

文件大小(字节)。

27007

FileUrl

string

文件 OSS 地址。

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

Region

string

文件存储区域。

cn-shanghai

FormatName

string

封装格式。

mp4

Duration

string

时长。

16.2

Bitrate

string

码率。

20

Width

string

宽。

960

Height

string

高。

540

CreateTime

string

文件创建时间。

2020-12-26T04:11:08Z

ModifiedTime

string

文件修改时间。

2020-12-26T04:11:10Z

AudioStreamInfoList

array<object>

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

object

音频流信息。

Index

string

音频流序号。

1

CodecName

string

编码格式简述名。

aac

CodecLongName

string

编码格式长述名。

AAC (Advanced Audio Coding)

CodecTimeBase

string

编码时基。

1/44100

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

起始时间。

2026-02-04T02:13:00Z

Duration

string

时长。

16.2

Bitrate

string

码率。

192.0

Fps

string

音频帧率。

10

NumFrames

string

总帧数。

10

Lang

string

语言。

zh

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

码率。

20

NumFrames

string

总帧数。

5184

Lang

string

语言。

zh

Rotate

string

旋转。

0

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

起始时间。

2025-03-07T01:30Z

Duration

string

时长。

1

Lang

string

语言。

zh

BizData

object

业务自定义信息。

FolderId

string

文件夹 ID。

fd-CBMEJaa2fA

ProductionId

string

项目 ID。

ID

AuditBlockedLabel

string

审核标签。

Label

AuditStatus

string

审核状态。

Status

MediaAssetType

string

媒资类型。

Type

MediaAssetSubType

string

媒资子类型。

SubType

SourceType

string

源类型。

MainBody

SourceId

string

源 ID。

f4a26390f02371f0a1f4e6e7c758****

SourceName

string

源名称。

SourceName

IsFavorite

string

是否最喜爱的。

1

IsLogicalDeleted

string

是否被删除。

1

CreationJobId

string

创建任务 ID。

ID

Prompt

string

提示词。

请为上述内容生成一段摘要,字数必须限制在70字以内包含标点符号

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfo": {
    "MediaId": "****20b48fb04483915d4f2cd8ac****",
    "MediaBasicInfo": {
      "MediaId": "****20b48fb04483915d4f2cd8ac****",
      "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
      "MediaType": "video",
      "BusinessType": "general",
      "Source": "oss",
      "Title": "v6l82k_176822379****.jpeg",
      "Description": "description",
      "Category": "category",
      "MediaTags": "tag1",
      "CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/01e1271d-ff4f-4689-9c20-e1df81486859_open_live_cover.jpg",
      "UserData": "UserData",
      "Snapshots": "[]",
      "Status": "Normal",
      "CreateTime": "2020-12-26T04:11:08Z",
      "ModifiedTime": "2020-12-26T04:11:10Z",
      "DeletedTime": "2020-12-26T04:11:15Z",
      "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\"}]",
      "CateId": 3048,
      "Biz": "AiSaas",
      "UploadSource": "general",
      "CateName": "cateName",
      "ReferenceId": "123-1234",
      "ThumbURL240P": "ThumbURL240P",
      "ThumbURLWebp": "ThumbURLWebp"
    },
    "FileInfoList": [
      {
        "FileBasicInfo": {
          "FileName": "example.mp4",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "27007",
          "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
          "Region": "cn-shanghai",
          "FormatName": "mp4",
          "Duration": "16.2",
          "Bitrate": "20",
          "Width": "960",
          "Height": "540",
          "CreateTime": "2020-12-26T04:11:08Z",
          "ModifiedTime": "2020-12-26T04:11:10Z"
        },
        "AudioStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/44100",
            "CodecTagString": "mp4a",
            "CodecTag": "0x6134706d",
            "Profile": "High",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "Channels": "2",
            "ChannelLayout": "stereo",
            "Timebase": "1/44100",
            "StartTime": "2026-02-04T02:13:00Z",
            "Duration": "16.2",
            "Bitrate": "192.0",
            "Fps": "10",
            "NumFrames": "10",
            "Lang": "zh"
          }
        ],
        "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": "20",
            "NumFrames": "5184",
            "Lang": "zh",
            "Rotate": "0"
          }
        ],
        "SubtitleStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "srt",
            "CodecLongName": "SubRip Text",
            "CodecTimeBase": "29.97",
            "CodecTagString": "unicode",
            "CodecTag": "unicode",
            "Timebase": "30",
            "StartTime": "2025-03-07T01:30Z",
            "Duration": "1",
            "Lang": "zh"
          }
        ]
      }
    ],
    "BizData": {
      "FolderId": "fd-CBMEJaa2fA",
      "ProductionId": "ID",
      "AuditBlockedLabel": "Label",
      "AuditStatus": "Status",
      "MediaAssetType": "Type",
      "MediaAssetSubType": "SubType",
      "SourceType": "MainBody",
      "SourceId": "f4a26390f02371f0a1f4e6e7c758****",
      "SourceName": "SourceName",
      "IsFavorite": "1",
      "IsLogicalDeleted": "1",
      "CreationJobId": "ID",
      "Prompt": "请为上述内容生成一段摘要,字数必须限制在70字以内包含标点符号"
    }
  }
}

错误码

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

变更历史

更多信息,参考变更详情