全部產品
Search

搜尋本產品

    ：CreateUploadImage - 擷取圖片上傳地址和憑證

    文件中心

    ：CreateUploadImage - 擷取圖片上傳地址和憑證

    更新時間：Dec 15, 2025

    點播服務下發上傳地址和憑證以保障授權和安全，防止惡意上傳，並在下發時自動建立圖片ID（ImageId）用於管理。通過調用本介面可擷取上傳所需地址和憑證，並建立圖片資訊。

    介面說明

    • 請確保在使用該介面前，已充分瞭解ApsaraVideo for VOD產品的收費方式和價格。媒資檔案上傳到ApsaraVideo for VOD中會產生儲存費用，計費詳情，請參見媒資儲存計費。如果您已開通了儲存傳輸加速，則上傳媒資檔案到ApsaraVideo for VOD時還將涉及上傳加速費用，計費詳情請參見儲存傳輸加速計費。

    • 本介面僅用於擷取上傳地址和憑證以及建立媒資基礎資訊，並非上傳檔案，通過介面上傳的完整樣本，請參見通過ApsaraVideo for VOD API 上傳媒資檔案。

    • 上傳圖片不支援重新整理上傳地址和憑證。如果圖片上傳憑證失效（ 預設有效期間 3000 秒），請重新調用此介面擷取上傳地址和憑證。

    • 可通過配置回調，接收圖片上傳完成的事件通知來判斷是否上傳成功。

    • 擷取上傳地址和憑證為點播服務的核心基礎，是每個上傳操作的必經過程。點播服務提供多種不同的上傳方式，每種方式對擷取上傳地址和憑證的要求不同，詳細內容請參見上傳地址和憑證的使用說明。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:CreateUploadImage

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Title

    string

    否

    圖片標題。規則：

    • 長度不超過 128 個字元。

    • UTF-8 編碼。

    mytitle
    ImageType

    string

    是

    圖片類型。取值：

    • default（預設）：普通圖片

    • cover：視頻封面圖

    說明

    點播控制台目前僅支援對 default 類型的圖片進行查看和管理。

    default
    ImageExt

    string

    否

    待上傳的圖片源檔案的副檔名。取值：

    • png（預設）

    • jpg

    • jpeg

    • gif

    • heic

    • webp

    png
    OriginalFileName

    string

    否

    待上傳的圖片源檔案地址。

    說明

    可不帶副檔名；若此處帶了副檔名，且此處的副檔名與ImageExt中設定的副檔名不一致，以ImageExt為準。

    D:\picture_01
    Tags

    string

    否

    圖片標籤。規則：

    • 單個標籤不超過 32 個字元。

    • 最多不超過 16 個標籤。

    • 多個標籤之間，請使用半形逗號（,）分隔。

    • UTF-8 編碼。

    測試
    StorageLocation

    string

    否

    儲存地址。可通過以下方式擷取： 登入點播控制台，選擇組態管理 > 媒資管理配置 > 儲存管理查看儲存地址。

    說明

    若不傳此參數，則圖片上傳到預設的儲存地址上；若傳入此參數，則圖片上傳到該指定的儲存地址上。

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

    integer

    否

    分類別識別碼。可通過以下方式擷取：

    • 登入點播控制台，選擇組態管理 > 媒資管理配置 > 分類管理查看分類別識別碼。

    • 通過 AddCategory 介面建立分類時，分類別識別碼 為返回參數 CateId 的值。

    • 通過 GetCategories 介面查詢分類時，為請求後返回參數 CateId 的值。

    100036****
    UserData

    string

    否

    自訂設定，為 JSON 字串，支援訊息回調、上傳加速等設定。詳情參見 UserData 。

    說明

    • 此參數中訊息回調的使用前提是需要在控制台配置 HTTP 回調地址和勾選對應的回調事件類型才能使用，否則回調設定不生效。控制台配置 HTTP 回調的操作，請參考回調設定。

    • 如需使用上傳加速功能，請提交工單申請開通，更多資訊，請參見上傳相關說明。關於如何提交工單，請參見聯絡我們。

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
    Description

    string

    否

    圖片描述。

    • 長度不超過 1024 個字元。

    • UTF-8 編碼。

    圖片上傳測試
    AppId

    string

    否

    應用 ID。預設取值：app-1000000。若已開通多應用體系，傳入應用 ID，可將圖片上傳到指定應用下。更多資訊，請參見多應用。

    app-1000000

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    FileURL

    string

    圖片檔案的 OSS 地址（不帶鑒權）。

    添加圖片浮水印模板時，該地址可作為 AddWatermark 介面的請求參數FileUrl。

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    RequestId

    string

    請求 ID。

    25818875-5F78-AEF6-D7393642****
    UploadAddress

    string

    上傳地址。

    說明

    介面返回的上傳地址是 Base64 加密後的值。調用 SDK 或 API 完成媒資上傳時需要對其進行 Base64 解碼後再使用。僅 OSS 原生 SDK 或 OSS API 方式上傳需要自行解析 UploadAddress。

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    圖片的訪問地址。

    說明

    如果返回的 ImageURL 在瀏覽器無法訪問（403），是因為您開啟了點播網域名稱的鑒權功能。可關閉 URL 鑒權或自助產生鑒權簽名。

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    ImageId

    string

    圖片 ID。可作為 GetImageInfo 、 GetImageInfos 、 UpdateImageInfos 、 DeleteImage 等介面的請求參數。

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    上傳憑證。

    說明

    介面返回的上傳憑證是 Base64 加密後的值。調用 SDK 或 API 完成媒資上傳時需要對其進行 Base64 解碼後再使用。僅 OSS 原生 SDK 或 OSS API 方式上傳需要自行解析 UploadAuth。

    eyJFbmmRCI6Im****

    樣本

    正常返回樣本

    JSON格式

    {
  "FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "RequestId": "25818875-5F78-AEF6-D7393642****",
  "UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
  "ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "ImageId": "93ab850b4f6f46e91d24d81d4****",
  "UploadAuth": "eyJFbmmRCI6Im****"
}

    錯誤碼

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

    變更歷史

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