全部產品
Search

搜尋本產品

    ApsaraVideo VOD：GetImageInfos

    文件中心

    ApsaraVideo VOD：GetImageInfos

    更新時間：Jul 21, 2026

    圖片上傳到影片點播後，可以呼叫本介面透過傳入多個圖片 ID，批次獲取圖片的基本資訊及存取位址。

    介面說明

    • 本介面僅支援查詢上傳到影片點播中的圖片資訊；如需查詢透過影片截圖產生的截圖資訊，請呼叫 ListSnapshots 介面查詢。

    • 一次最多可查詢 20 個圖片的資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetImageInfos

    list

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ImageIds

    string

    是

    圖片 ID 清單，多個 ID 之間使用半形逗號（,）分隔，最多支援 20 個 ID。可透過以下方式獲取：

    bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a****
    AuthTimeout

    integer

    否

    圖片存取位址的過期時間。單位：秒。

    • 當 OutputType 取值為 cdn 時：

      • 只有開啟了 URL 鑑權的圖片位址才會過期失效，否則會永久有效。

      • 最小值：1。

      • 最大值：無限制。

      • 預設值：未設定時，取值為 URL 鑑權中設定的預設有效時長。

    • 當 OutputType 取值為 oss 時：

      • 只有儲存權限為私有，播放位址才會過期失效，否則會永久有效。

      • 最小值：1。

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

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

    3600
    OutputType

    string

    否

    輸出的圖片存取位址的類型。取值範圍：

    • oss：回源位址。

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

    cdn

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

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

    array<object>

    圖片資訊清單。

    array<object>

    圖片資訊清單。

    CreationTime

    string

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

    2018-11-21T02:37:23Z
    StorageLocation

    string

    圖片檔案的儲存位址。

    outin-****..oss-cn-shanghai.aliyuncs.com
    Status

    string

    圖片狀態。取值：

    • Uploading：初始狀態，表示圖片正在上傳。

    • Normal：圖片上傳成功。

    • UploadFail：圖片上傳失敗。

    Uploading
    CateId

    integer

    分類 ID。

    254766071
    Tags

    string

    圖片標籤。多個標籤之間使用半形逗號（,）分隔。

    tag1,tag2,tag3
    ImageType

    string

    圖片類型。取值：

    • default：普通圖片

    • cover：影片封面圖

    default
    CateName

    string

    分類名稱。

    Test
    Description

    string

    圖片描述。

    Test description
    AppId

    string

    應用程式 ID。

    app-****
    URL

    string

    圖片存取位址（如果設定了 CDN 網域則為 CDN 位址，否則為 OSS 位址）。

    http://example.aliyundoc.com/image/default/****.gif?auth_key=****
    Title

    string

    圖片標題。

    this is a sample
    ImageId

    string

    圖片 ID。

    bbc65bba53f9*****ed90de118a7849
    Mezzanine

    object

    圖片來源資訊。

    FileURL

    string

    圖片檔案的 OSS 地址。

    https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D
    OriginalFileName

    string

    上傳的圖片源檔案地址。

    ****.gif
    Width

    integer

    圖片寬度。單位：像素。

    200
    Height

    integer

    圖片高度。單位：像素。

    200
    FileSize

    string

    檔案大小。單位：位元組。

    8932
    NonExistImageIds

    array

    不存在的圖片 ID 清單。

    string

    不存在的圖片 ID 清單。

    f45cf4eba5c80233389558c39****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58*****",
  "ImageInfo": [
    {
      "CreationTime": "2018-11-21T02:37:23Z",
      "StorageLocation": "outin-****..oss-cn-shanghai.aliyuncs.com",
      "Status": "Uploading",
      "CateId": 254766071,
      "Tags": "tag1,tag2,tag3",
      "ImageType": "default",
      "CateName": "测试",
      "Description": "测试描述",
      "AppId": "app-****",
      "URL": "http://example.aliyundoc.com/image/default/****.gif?auth_key=****",
      "Title": "this is a sample",
      "ImageId": "bbc65bba53f9*****ed90de118a7849",
      "Mezzanine": {
        "FileURL": "https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
        "OriginalFileName": "****.gif",
        "Width": 200,
        "Height": 200,
        "FileSize": "8932"
      }
    }
  ],
  "NonExistImageIds": [
    "f45cf4eba5c80233389558c39****"
  ]
}

    錯誤碼

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

    變更歷史

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