全部產品
Search
文件中心

Intelligent Media Services:GetPublicMediaInfo - 擷取公用著作權媒資

更新時間:Apr 21, 2026

根據ICE公用著作權媒資的 mediaId,擷取並返回媒資資訊。介面返回的URL為著作權媒資的試聽或試看地址,合成時會使用正式素材。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

MediaId

string

否

IMS 媒資 ID

icepublic-****14e501538aeef0a3140176f6****

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

RequestId

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

MediaInfo

object

媒資資訊

MediaId

string

媒資 ID

icepublic-****14e501538aeef0a3140176f6****

MediaBasicInfo

object

BasicInfo

MediaId

string

MediaId

icepublic-****14e501538aeef0a3140176f6****

MediaType

string

媒資媒體類型

video

BusinessType

string

媒資業務類型

general

Source

string

來源

oss

Title

string

標題

title

Description

string

內容描述

description

Category

string

分類

category

MediaTags

string

標籤

標籤,tag1

CoverURL

string

封面地址

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

UserData

string

使用者資料

{"key":"value"}

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

DynamicMetaData

object

公用媒資動態中繼資料

Type

string

類型。取值範圍:

  • "ai": AI 原始結果統一化處理後的 AI 資料

  • "user-defined": 使用者自訂中繼資料

  • "system": 系統內建

system

Data

string

中繼資料 json

{"AuditionUrl": "http://example-bucket.cdn.domain.com/example.mp4", "AuditionCount": 3}

FileInfoList

array<object>

FileInfos

array<object>

FileBasicInfo

object

檔案基礎資訊,包含時間長度,大小等

FileName

string

檔案名稱

example.mp4

FileStatus

string

檔案狀態

Normal

FileType

string

檔案類型

source_file

FileSize

string

檔案大小(位元組)

27007

FileUrl

string

著作權媒資試聽或試看地址。

http://example-bucket.cdn.domain.com/example.mp4

Region

string

檔案儲存體地區

cn-shanghai

FormatName

string

封裝格式

mp4

Duration

string

時間長度

16.2

Bitrate

string

碼率

192.0

Width

string

寬

0

Height

string

高

0

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

起始時間

0.000000

Duration

string

時間長度

16.2

Bitrate

string

碼率

192.0

Fps

string

音訊框架率

10

NumFrames

string

總幀數

162

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

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfo": {
    "MediaId": "icepublic-****14e501538aeef0a3140176f6****",
    "MediaBasicInfo": {
      "MediaId": "icepublic-****14e501538aeef0a3140176f6****",
      "MediaType": "video",
      "BusinessType": "general",
      "Source": "oss",
      "Title": "title",
      "Description": "description",
      "Category": "category",
      "MediaTags": "標籤,tag1",
      "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
      "UserData": "{\"key\":\"value\"}",
      "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\"}]"
    },
    "DynamicMetaData": {
      "Type": "system",
      "Data": "{\"AuditionUrl\": \"http://example-bucket.cdn.domain.com/example.mp4\", \"AuditionCount\": 3}"
    },
    "FileInfoList": [
      {
        "FileBasicInfo": {
          "FileName": "example.mp4",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "27007",
          "FileUrl": "http://example-bucket.cdn.domain.com/example.mp4",
          "Region": "cn-shanghai",
          "FormatName": "mp4",
          "Duration": "16.2",
          "Bitrate": "192.0",
          "Width": "0",
          "Height": "0"
        },
        "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": "0.000000",
            "Duration": "16.2",
            "Bitrate": "192.0",
            "Fps": "10",
            "NumFrames": "162",
            "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"
          }
        ]
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。