全部產品
Search

搜尋本產品

    ApsaraVideo VOD：CreateUploadVideo

    文件中心

    ApsaraVideo VOD：CreateUploadVideo

    更新時間：Jul 21, 2026

    點播服務下發上傳位址和憑證以保障授權和安全，防止惡意上傳，並在下發時自動建立媒體 ID（MediaId），也稱影片 ID（VideoId）用於管理。透過呼叫本介面可獲取上傳所需位址和憑證，並建立影音資訊。

    介面說明

    • 請確保在使用該介面前，已充分了解影片點播產品的收費方式和價格。媒資檔案上傳到影片點播中會產生儲存費用，計費詳情，請參見媒資儲存計費。如果您已啟用了儲存傳輸加速，則上傳媒資檔案到影片點播時還將涉及上傳加速費用，計費詳情請參見儲存傳輸加速計費。儲存費用從檔案上傳成功開始計算，加速費用在啟用後進行上傳操作時進行計算，僅呼叫本介面不計費。

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

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

    • 本介面既支援獲取影片的上傳位址和憑證，同時也支援獲取音訊的上傳位址和憑證。具體操作，請參見上傳位址和憑證。

    • 如果影片上傳憑證失效（預設有效期為 3000 秒），請呼叫 RefreshUploadVideo 介面重新獲取上傳憑證。

    • 上傳後，可透過設定回呼，接收上傳事件通知或呼叫 GetMezzanineInfo 介面根據返回的檔案狀態來判斷是否上傳成功。

    • 本介面返回的 VideoId 參數，可以用於媒資生命週期管理或媒體處理。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:CreateUploadVideo

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    CoverURL

    string

    否

    自訂影片封面的 URL 位址。

    https://example.aliyundoc.com/image/D22F553TEST****.jpeg
    Description

    string

    否

    上傳完成後，在點播中展示的音/影片描述。

    • 長度不超過 1024 個字元。

    • UTF-8 編碼。

    UploadTest
    FileName

    string

    是

    待上傳的音/影片原始檔案位址。

    • 必須帶副檔名，且副檔名不區分大小寫。

    • 支援的副檔名，請參見上傳概述。

    D:\video_01.mp4
    FileSize

    integer

    否

    待上傳的音/影片原始檔案的大小。單位：位元組。

    123
    Title

    string

    是

    上傳完成後，在點播中展示的音/影片標題。

    • 長度不超過 128 個字元。

    • UTF-8 編碼。

    UploadTest
    CateId

    integer

    否

    分類 ID。可透過以下方式獲取：

    • 登入點播控制台，選擇配置管理 > 媒資管理配置 > 分類管理查看分類 ID。

    • 透過 AddCategory 介面建立分類時，分類 ID 為返回參數 CateId 的值。

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

    100036****
    Tags

    string

    否

    音/影片標籤。

    • 最多不超過 16 個標籤。

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

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

    • UTF-8 編碼。

    tag1,tag2
    UserData

    string

    否

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

    說明

    • 此參數中訊息回呼的使用前提是需要在控制台設定 HTTP 回呼位址並勾選對應的回呼事件類型才能使用，否則回呼設定不生效。同時後續任務未指定回呼位址時，均預設推送至此位址。控制台設定 HTTP 回呼的操作，請參考回呼設定。

    • 如需使用上傳加速功能，您需要填寫宜搭資訊申請啟用，更多資訊，請參見上傳相關說明。

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

    string

    否

    轉碼範本群組 ID。可透過以下方式獲取：

    • 登入點播控制台，選擇配置管理 > 媒體處理配置 > 轉碼範本群組查看轉碼範本群組 ID。

    • 透過建立轉碼範本群組介面建立轉碼範本群組時，轉碼範本群組 ID 為返回參數 TranscodeTemplateGroupId 的值。

    • 透過查詢轉碼配置列表介面查詢轉碼範本群組時，為請求後返回參數 TranscodeTemplateGroupId 的值。

    說明

    • 如果同時傳遞了 WorkflowId 和 TemplateGroupId，以 WorkflowId 為準。

    • 若不傳入本參數，則按預設的轉碼範本群組進行轉碼；若傳入了轉碼範本群組 ID 時，則按指定的範本群組進行轉碼。

    • 若設定為系統內建的不轉碼範本群組，則影音上傳後，僅有影片上傳完成的事件通知，沒有單一清晰度轉碼完成的事件通知。

    • 該參數任務為非同步任務，提交後任務尚未完成，任務將進入後台排隊非同步執行。

    • 為確保正常播放，當設定為系統內建的不轉碼範本群組，則影音上傳完成後，僅以下格式支援不轉碼直接播放：MP4、FLV、MP3、M3U8、WEBM，其他格式僅支援儲存（關注 FileName 的副檔名）；若使用阿里雲播放器播放，則版本須為 3.1.0 或以上。

    405477f9e214d19ea2c7c854****
    WorkflowId

    string

    否

    工作流程 ID。可登入點播控制台，選擇配置管理 > 媒體處理配置 > 工作流程管理查看工作流程 ID。

    說明

    • 如果同時傳遞了 WorkflowId 和 TemplateGroupId，以 WorkflowId 為準。使用說明，請參見工作流程。

    • 該參數任務為非同步任務，提交後任務尚未完成，任務將進入後台排隊非同步執行。

    613efff3887ec34af685714cc461****
    StorageLocation

    string

    否

    儲存位址。可透過以下方式獲取： 登入點播控制台，選擇配置管理 > 媒資管理配置 > 儲存管理查看儲存位址。

    說明

    若不傳此參數，則影音檔案上傳至預設的儲存位址上（無預設儲存位址時上傳至儲存清單第一個儲存位址）；若傳入此參數，則影音檔案上傳至該指定的儲存位址上。

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

    string

    否

    應用程式 ID。預設取值：app-1000000。更多資訊，請參見多應用。

    app-1000000
    ReferenceId

    string

    否

    自訂 ID，僅支援小寫字母、大寫字母、數字、橫線、底線，長度 6-64 位元。使用者維度唯一。

    123-123
    EnableFirstFrameCover

    boolean

    否

    GenerateThumbnail

    boolean

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    25818875-5F78-4AF6-04D5-D7393642****
    UploadAddress

    string

    上傳位址。

    說明

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

    eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    VideoId

    string

    音/影片 ID。可作為媒資管理、媒體處理、媒體審核等介面的請求參數。

    93ab850b4f6f54b6e91d24d81d44****
    UploadAuth

    string

    上傳憑證。

    說明

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

    eyJFbmRwb2ludCI6Imm****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    錯誤碼

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

    變更歷史

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