全部產品
Search

搜尋本產品

    ：GetImageInfo - 擷取單個圖片資訊

    文件中心

    ：GetImageInfo - 擷取單個圖片資訊

    更新時間：Dec 15, 2025

    圖片上傳至ApsaraVideo for VOD後，可調用本介面通過圖片ID擷取其基本資料及訪問地址。

    介面說明

    本介面僅支援查詢上傳到ApsaraVideo for VOD中的圖片資訊；如需查詢通過視頻截圖產生的截圖資訊，請調用 ListSnapshots 介面查詢。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetImageInfo

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ImageId

    string

    是

    圖片 ID。可通過以下方式擷取：

    3e34733b40b9a96ccf5c1ff6f69****
    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。

    AB99D4DF-FAFA-49DC-9C548C1E261E****
    ImageInfo

    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

    分類別識別碼。

    254766071
    Tags

    string

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

    tag1,tag2,tag3
    ImageType

    string

    圖片類型。取值：

    • default：普通圖片

    • cover：視頻封面圖

    default
    CateName

    string

    分類名稱。

    測試
    Description

    string

    圖片描述。

    測試描述
    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

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "AB99D4DF-FAFA-49DC-9C548C1E261E****",
  "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"
    }
  }
}

    錯誤碼

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

    變更歷史

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