全部產品
Search

搜尋本產品

    ：ListDynamicImage - 查詢動圖列表

    文件中心

    ：ListDynamicImage - 查詢動圖列表

    更新時間：Dec 15, 2025

    調用本介面，通過視頻ID查詢視頻截動圖列表。

    介面說明

    使用說明

    • 視頻動圖截取完成後，可以調用本介面來擷取視頻的動圖資訊。

    • 視頻動圖任務可通過 API（提交媒體動圖作業介面）或控制台發起，更多內容，請參見視頻動圖。

    QPS 限制

    本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:ListDynamicImage

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    VideoId

    string

    是

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

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

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

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

    2e114f1100590c3193918fd449a****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    570189B6-572E-4953-13B4278EE0D8****
    DynamicImageList

    array<object>

    動圖結果。

    object

    動圖詳情。

    CreationTime

    string

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

    2020-07-28T02:01:06Z
    FileURL

    string

    動圖檔案地址。

    https://example.aliyundoc.com/2e114f110059*****0c3193918fd449a/image/dynamic/2b4e51df60*****323ef43d6e336ecf.webp?auth_key=1597296785-0-0-4a48e85*****bd2bb358e0b3cade
    VideoId

    string

    視頻 ID。

    2e114f1100590c3193918fd449a****
    Width

    string

    動圖寬。單位：px。

    640
    JobId

    string

    動圖作業 ID。

    2bf4390af9e5491c09cc720ad****
    Height

    string

    動圖高。單位：px。

    360
    Fps

    string

    動圖幀率。單位：幀/每秒。

    10
    Duration

    string

    動圖時間長度。單位：秒。

    2
    Format

    string

    動圖格式，取值：

    • gif。

    • webp。

    webp
    DynamicImageId

    string

    動圖 ID。

    2b4e51df60323ef43d6e336ecf****
    FileSize

    string

    動圖檔案大小。單位：Byte。

    119866

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "570189B6-572E-4953-13B4278EE0D8****",
  "DynamicImageList": [
    {
      "CreationTime": "2020-07-28T02:01:06Z",
      "FileURL": "https://example.aliyundoc.com/2e114f110059*****0c3193918fd449a/image/dynamic/2b4e51df60*****323ef43d6e336ecf.webp?auth_key=1597296785-0-0-4a48e85*****bd2bb358e0b3cade",
      "VideoId": "2e114f1100590c3193918fd449a****",
      "Width": "640",
      "JobId": "2bf4390af9e5491c09cc720ad****",
      "Height": "360",
      "Fps": "10",
      "Duration": "2",
      "Format": "webp",
      "DynamicImageId": "2b4e51df60323ef43d6e336ecf****",
      "FileSize": "119866"
    }
  ]
}

    錯誤碼

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

    變更歷史

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