全部產品
Search

搜尋本產品

    ：GetMezzanineInfo - 擷取源檔案資訊

    文件中心

    ：GetMezzanineInfo - 擷取源檔案資訊

    更新時間：Dec 09, 2025

    擷取音視頻的源檔案資訊，包括檔案地址、解析度、碼率等。

    介面說明

    當一路視頻或音頻流轉碼完成後才可以擷取到完整的源檔案資訊。

    調試

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

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetMezzanineInfo

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    VideoId

    string

    否

    音/視頻 ID。可通過以下方式擷取：

    • 通過控制台上傳的音/視頻，可登入點播控制台，選擇媒資庫 > 音/視頻查看視頻 ID。

    • 通過擷取視頻上傳地址和憑證介面擷取上傳地址和憑證時，音/視頻 ID 為返回參數 VideoId 的值。

    • 視頻上傳後，可通過搜尋媒體資訊介面查詢音/視頻 ID，為請求後返回參數 VideoId 的值。

    1f1a6fc03ca04814031b8a6559e****
    AuthTimeout

    integer

    否

    FileURL（源檔案地址）簽名到期時間。單位：秒。預設值為 3600，支援設定最小值為 1。

    • 如果 OutputType 取值為 cdn：

      • 只有開啟了 URL 鑒權，FileURL 才會定期失效，否則會永久有效。

      • 最小值：1。

      • 最大值：無限制。

      • 預設值：未設定時，取值為 3600。

    • 如果 OutputType 取值為 oss：

      • 只有儲存許可權為私人，FileURL 才會定期失效，否則會永久有效。

      • 最小值：1。

      • 最大值：為降低來源站點安全風險，當音視頻儲存在點播系統 Bucket 上時，最大值為 2592000（即 30 天），當音視頻儲存在 OSS 自有 Bucket 上時，最大值為 129600（即 36 小時）。

      • 預設值：未設定時，取值為 3600。

    3600
    OutputType

    string

    否

    輸出地址類型。取值：

    • oss：回源地址。

    • cdn（預設）：加速地址。

    說明

    當源檔案所在的 bucket 類型為 in 時，只返回 OSS 地址。

    oss
    AdditionType

    string

    否

    附加資訊類型。多個使用半形逗號（,）分隔，預設只返回基本資料。取值：

    • video：視頻流資訊。

    • audio：音頻流資訊。

    video
    ReferenceId

    string

    否

    自訂 ID，僅支援小寫字母、大寫字母、數字、橫線、底線，長度 6-64 位元。使用者維度唯一。

    123-123

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    25818875-5F78-4AF6-D7393642CA58****
    Mezzanine

    object

    檔案資訊。

    CreationTime

    string

    檔案建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2017-11-14T09:15:50Z
    Status

    string

    檔案狀態。取值：

    • Uploading（上傳中）：檔案的初始狀態，表示正在上傳。

    • Normal（正常）：檔案上傳成功。

    • UploadFail（失敗）：檔案上傳失敗。

    • Deleted（刪除）：檔案被刪除。

    Normal
    FileURL

    string

    源檔案地址。

    http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
    VideoId

    string

    視頻 ID。

    1f1a6fc03ca04814031b8a6559e****
    Height

    integer

    檔案高度。單位：px。

    540
    Bitrate

    string

    檔案碼率。單位：Kbps。

    771.2280
    FileName

    string

    檔案名稱。

    27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
    OutputType

    string

    輸出地址類型。取值範圍 ：

    • oss：回源地址。

    • cdn（預設）：加速地址。

    說明

    僅支援播放格式為 MP4 的 OSS 地址。

    oss
    PreprocessStatus

    string

    預先處理狀態 。取值：

    • UnPreprocess：未進行預先處理。

    • Preprocessing：預先處理中。

    • PreprocessSucceed：預先處理完成。

    • PreprocessFailed：預先處理失敗。

    UnPreprocess
    Width

    integer

    檔案寬度。單位：px。

    960
    Size

    integer

    檔案大小。單位：Byte。

    4096477
    Duration

    string

    檔案時間長度。單位：秒。

    42.4930
    Fps

    string

    檔案幀率，每秒多少幀。

    25.0000
    AudioStreamList

    array<object>

    音頻流資訊。

    object

    音頻流詳情。

    Index

    string

    音頻流序號，標識音頻流在整個媒體流中的位置。

    0
    Timebase

    string

    時基。

    0.000000
    SampleFmt

    string

    採樣格式。

    fltp
    SampleRate

    string

    採樣率。

    44100
    ChannelLayout

    string

    聲道輸出樣式。取值：

    • mono：單聲道。

    • stereo：雙聲道。

    mono
    Lang

    string

    語言。

    und
    CodecLongName

    string

    編碼格式長述名。

    AAC (Advanced Audio Coding)
    Channels

    string

    聲道數。

    1
    NumFrames

    string

    總幀數。

    1
    Bitrate

    string

    碼率。

    62.885
    CodecTagString

    string

    編碼格式標記文本。

    mp4a
    StartTime

    string

    起始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2017-01-11T12:00:00Z
    CodecName

    string

    編碼格式簡述名。

    aac
    Duration

    string

    時間長度。

    3.227574
    CodecTag

    string

    編碼格式標記。

    0x6134706d
    CodecTimeBase

    string

    編碼時基。

    1/44100
    VideoStreamList

    array<object>

    視頻流資訊。

    object

    視頻流詳情。

    Timebase

    string

    時基。

    0.000000
    Index

    string

    視頻流序號，標識視頻流在整個媒體流中的位置。

    1
    AvgFPS

    string

    平均幀率。

    30.0
    PixFmt

    string

    像素格式。

    yuv420p
    Lang

    string

    語言。

    und
    Sar

    string

    編碼訊號解析度比。

    0:1
    Height

    string

    視頻解析度長。

    320
    CodecLongName

    string

    編碼格式長述名。

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

    string

    總幀數。

    0
    Bitrate

    string

    檔案碼率。單位：Kbps。

    500
    Rotate

    string

    視頻旋轉角度，取值範圍：[0，360)。

    90
    CodecTagString

    string

    編碼格式標記文本。

    avc1
    HasBFrames

    string

    是否有 B 幀。

    0
    Profile

    string

    編碼預置。

    Main
    StartTime

    string

    起始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2017-01-11T12:00:00Z
    Dar

    string

    編碼顯示解析度比。

    0:1
    CodecName

    string

    編碼格式簡述名。

    h264
    Width

    string

    視頻解析度寬。

    568
    Duration

    string

    時間長度。

    3.166667
    Fps

    string

    目標幀率。

    30.0
    CodecTag

    string

    編碼格式標記。

    0x31637661
    CodecTimeBase

    string

    編碼時基。

    1/60
    Level

    string

    編碼等級。

    30
    HDRType

    string

    視頻流 HDR 類型。

    HDR
    StorageClass

    string

    媒資儲存類型。取值：

    • Standard：標準。

    • IA：媒資低頻。

    • Archive：媒資歸檔。

    • ColdArchive：媒資冷歸檔。

    • SourceIA：源檔案低頻。

    • SourceArchive：源檔案歸檔。

    • SourceColdArchive：源檔案冷歸檔。

    • Changing：媒資儲存類型變更中。

    • SourceChanging：源檔案儲存體類型變更中。

    Standard
    RestoreStatus

    string

    媒資解凍狀態。取值：

    • Processing：解凍中。

    • Success：解凍成功。

    • Failed：解凍失敗。

    Success
    RestoreExpiration

    string

    媒資解凍有效期間。

    2023-03-30T10:14:14Z
    FileMD5

    string

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "Width": 960,
    "Size": 4096477,
    "Duration": "42.4930",
    "Fps": "25.0000",
    "AudioStreamList": [
      {
        "Index": "0",
        "Timebase": "0.000000",
        "SampleFmt": "fltp",
        "SampleRate": "44100",
        "ChannelLayout": "mono",
        "Lang": "und",
        "CodecLongName": "AAC (Advanced Audio Coding)",
        "Channels": "1",
        "NumFrames": "1",
        "Bitrate": "62.885",
        "CodecTagString": "mp4a",
        "StartTime": "2017-01-11T12:00:00Z",
        "CodecName": "aac",
        "Duration": "3.227574",
        "CodecTag": "0x6134706d",
        "CodecTimeBase": "1/44100"
      }
    ],
    "VideoStreamList": [
      {
        "Timebase": "0.000000",
        "Index": "1",
        "AvgFPS": "30.0",
        "PixFmt": "yuv420p",
        "Lang": "und",
        "Sar": "0:1",
        "Height": "320",
        "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
        "NumFrames": "0",
        "Bitrate": "500",
        "Rotate": "90",
        "CodecTagString": "avc1",
        "HasBFrames": "0",
        "Profile": "Main",
        "StartTime": "2017-01-11T12:00:00Z",
        "Dar": "0:1",
        "CodecName": "h264",
        "Width": "568",
        "Duration": "3.166667",
        "Fps": "30.0",
        "CodecTag": "0x31637661",
        "CodecTimeBase": "1/60",
        "Level": "30",
        "HDRType": "HDR"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

    錯誤碼

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

    變更歷史

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