全部產品
Search

搜尋本產品

    ：GetTranscodeSummary - 查詢音視頻轉碼摘要

    文件中心

    ：GetTranscodeSummary - 查詢音視頻轉碼摘要

    更新時間：Dec 15, 2025

    調用本介面根據音視頻ID查詢音視頻轉碼摘要，包括音視頻轉碼狀態、轉碼進展等匯總資訊。

    介面說明

    • 由於音視頻可能存在多次轉碼，故本介面只返回最近一次的轉碼摘要。

    • 支援批量查詢，單次最多可查詢 10 個音視頻的轉碼摘要。

    • 如需查詢歷史轉碼任務資訊，可調用 ListTranscodeTask 介面查詢。

    • 本介面僅支援查詢一年內的轉碼任務資料。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetTranscodeSummary

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    VideoIds

    string

    是

    音/視頻 ID。最多支援 10 個 ID，多個 ID 之間使用半形逗號（,）分隔。音/視頻 ID 可通過以下方式擷取：

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

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

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

    "d4860fcc6ae9fed52e8938244****,e1db68cc586644b83e562bcd94****,hhhhhhh"

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    25818875-5F78-4A*****F6-D7393642CA58
    NonExistVideoIds

    array

    不存在的音/視頻 ID 列表。

    string

    不存在的音/視頻 ID 列表。

    ["hhhhhhh"]
    TranscodeSummaryList

    array<object>

    音/視頻轉碼基礎資訊列表。

    array<object>

    CreationTime

    string

    轉碼任務建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-01-23T12:35:12Z
    VideoId

    string

    音/視頻 ID。

    e1db68cc586644b83e562bcd94****
    CompleteTime

    string

    轉碼任務完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-01-23T12:40:12Z
    TranscodeStatus

    string

    轉碼處理狀態。取值：

    • Processing：處理中。

    • Partial：部分轉碼完成。

    • CompleteAllSucc：全部處理完成，且全部轉碼成功。

    • CompleteAllFail：全部處理完成，且全部轉碼失敗，如果源片有問題，則不會發起任何轉碼作業，整個轉碼任務失敗。

    • CompletePartialSucc：全部轉碼完成，但僅部分轉碼成功。

    Processing
    TranscodeTemplateGroupId

    string

    轉碼使用的模板組 ID。

    44f9e406bbb*****736a9abe876ecc0
    TranscodeJobInfoSummaryList

    array<object>

    轉碼作業摘要資訊列表。

    object

    CreationTime

    string

    轉碼作業建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-02-27T03:34:46Z
    ErrorMessage

    string

    轉碼失敗的錯誤資訊。

    ErrorMessage
    Height

    string

    轉碼輸出視頻的畫面高。單位：px。

    960
    TranscodeProgress

    integer

    轉碼進度。取值範圍：[0,100]。

    100
    TranscodeTemplateId

    string

    使用的轉碼模板 ID。

    57496724ae2*****0968d6e08acc8f6
    Bitrate

    string

    轉碼輸出視頻的平均碼率。單位：Kbps。

    749
    ErrorCode

    string

    轉碼失敗的錯誤碼。

    200
    CompleteTime

    string

    轉碼作業完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2019-02-27T03:40:51Z
    Width

    string

    轉碼輸出視頻的畫面寬。單位：px。

    544
    Duration

    string

    轉碼輸出視頻時間長度。單位：秒。

    12
    Fps

    string

    轉碼輸出視頻的幀率。單位：幀/秒。

    30
    TranscodeJobStatus

    string

    轉碼作業狀態。取值：

    • Transcoding：轉碼中。

    • TranscodeSuccess：轉碼成功。

    • TranscodeFail：轉碼失敗。

    Transcoding
    Filesize

    integer

    轉碼輸出視頻的檔案大小。單位：Byte。

    1144259
    Format

    string

    轉碼輸出視頻的封裝格式。

    mp4
    WatermarkIdList

    array

    轉碼使用的浮水印列表。

    string

    轉碼使用的浮水印列表。

    ["af2afe4761992c*****d947dae97337"]

    錯誤碼

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

    變更歷史

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