全部產品
Search

搜尋本產品

    ApsaraVideo VOD：CreateUploadAttachedMedia

    文件中心

    ApsaraVideo VOD：CreateUploadAttachedMedia

    更新時間：Jul 21, 2026

    上傳地址和憑證由影片點播服務提供，旨在解決授權與安全問題，防止惡意上傳，並自動建立用於管理和處理的媒資 ID（Mediaid）。輔助媒資如浮水印、字幕等，透過呼叫本介面獲取上傳憑證並建立相應媒資資訊。

    介面說明

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

    • 本介面僅用於獲取上傳地址和憑證以及建立媒資基礎資訊，並非上傳檔案，透過介面上傳的完整範例，請參見透過影片點播 API 上傳媒資檔案。

    • 如果上傳憑證失效（有效期 3000 秒），請重新呼叫此介面獲取上傳地址和憑證。

    • 可透過設定回呼，接收輔助媒資上傳完成的事件通知來判斷是否上傳成功。

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:CreateUploadAttachedMedia

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Title

    string

    否

    輔助媒資的標題。規則：

    • 長度不超過 128 個位元組。

    • UTF8 編碼。

    Test
    BusinessType

    string

    是

    輔助媒資的類型。取值：

    • watermark：浮水印。

    • subtitle：字幕。

    • material：素材。

    watermark
    MediaExt

    string

    否

    待上傳的輔助媒資原始檔案的副檔名。取值：

    • 浮水印：png、gif、apng、mov。

    • 字幕：srt、ass、stl、ttml、vtt。

    • 素材：jpg、gif、png、mp4、mat、zip、apk。

    枚舉值：

    • ass :

      ass

    • jpg :

      jpg

    • zip :

      zip

    • mat :

      mat

    • gif :

      gif

    • apng :

      apng

    • png :

      png

    • ttml :

      ttml

    • stl :

      stl

    • mp4 :

      mp4

    • srt :

      srt

    • mov :

      mov

    • vtt :

      vtt

    • apk :

      apk

    png
    FileName

    string

    否

    待上傳的輔助媒資的原始檔案地址。

    說明

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

    D:\test.png
    FileSize

    string

    否

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

    123
    Tags

    string

    否

    標籤。規則：

    • 最多不超過 16 個標籤。

    • 如需設定多個標籤，請使用半形逗號（,）分隔。

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

    • UTF-8 編碼。

    tag1,tag2
    StorageLocation

    string

    否

    儲存地址。可透過以下方式獲取：

    登入影片點播主控台，選擇設定管理 > 媒資管理設定 > 儲存管理檢視儲存地址。

    說明

    若不傳此參數，則輔助媒資上傳到預設的儲存地址上；若傳入此參數，則輔助媒資上傳到該指定的儲存地址上。

    out-****.oss-cn-shanghai.aliyuncs.com
    Description

    string

    否

    媒資描述。規則：

    • 長度不超過 1024 個位元組。

    • UTF-8 編碼。

    uploadTest
    UserData

    string

    否

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

    說明

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

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

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

    string

    否

    分類 ID。多個 ID 之間使用半形逗號（,）分隔。最多支援 5 個。可透過以下方式獲取：

    1298****,0813****
    AppId

    string

    否

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

    app-****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    FileURL

    string

    輔助媒資檔案的 OSS 地址（不帶鑑權）。

    新增圖片浮水印範本時，該地址可做為 AddWatermark 介面的請求參數 FileUrl。

    https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov
    RequestId

    string

    請求 ID。

    73254DE5-F260-4720-D06856B63C01****
    UploadAddress

    string

    上傳地址。

    說明

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

    LWNuLXNoYW5naGFpLmFsaXl1b****
    MediaId

    string

    媒資 ID。

    97dc17a5abc3668489b84ce9****
    MediaURL

    string

    媒資的存取地址。

    如果設定了 CDN 網域則返回 CDN 地址，否則為 OSS 地址。

    說明

    如果返回的 MediaURL 在瀏覽器無法存取（403），是因為您開啟了影片點播網域的鑑權功能。可關閉 URL 鑑權或自助產生鑑權簽章。

    http://example.aliyundoc.com/watermark/****.mov?auth_key=****
    UploadAuth

    string

    上傳憑證。

    說明

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

    UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****

    樣本

    正常返回樣本

    JSON格式

    {
  "FileURL": "https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov",
  "RequestId": "73254DE5-F260-4720-D06856B63C01****",
  "UploadAddress": "LWNuLXNoYW5naGFpLmFsaXl1b****",
  "MediaId": "97dc17a5abc3668489b84ce9****",
  "MediaURL": "http://example.aliyundoc.com/watermark/****.mov?auth_key=****",
  "UploadAuth": "UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****"
}

    錯誤碼

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

    變更歷史

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