全部產品
Search

搜尋本產品

    ApsaraVideo VOD：ProduceEditingProjectVideo

    文件中心

    ApsaraVideo VOD：ProduceEditingProjectVideo

    更新時間：Jul 21, 2026

    將一個或多個影片合成為成品。可以透過時間線參數直接提交來源影片，也可以先建立雲端剪輯專案，再提交合成。

    介面說明

    • 請確保在使用該介面前，已充分了解影片點播產品的收費方式和價格。雲端剪輯為付費功能，計費詳情，請參見剪輯合成計費。

    • 該介面為非同步介面，提交任務後返回雲端剪輯專案 ID（此時影片尚未完成合成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過獲取單個雲端剪輯專案主動查詢任務狀態。

    • 雲端剪輯時間線所使用的影片資源，既可以是素材管理中的素材，也可以是媒體庫中的影片，使用媒體庫中的影片需要確保其狀態為正常（Normal）。

    • 合成影片依據 ProjectId 與 Timeline 進行，具體邏輯如下：

      • ProjectId 與 Timeline 不能同時為空，否則合成影片沒有任何依據。

      • 如果 ProjectId 為空，Timeline 不為空，則自動建立一個雲端剪輯專案，以 Timeline 為時間線，同時提取 Timeline 中引用的素材並設定為雲端剪輯專案的素材，之後進行影片合成。

      • 如果 ProjectId 不為空，Timeline 為空，則根據 ProjectId 獲取最新儲存的 Timeline，並以此進行影片合成。

      • 如果 ProjectId 與 Timeline 均不為空，則以傳入的 Timeline 為準，進行影片合成，同時更新對應的雲端剪輯專案（Timeline 和雲端剪輯專案素材）。如果填寫其他欄位，則對相應的雲端剪輯專案欄位進行更新。

    • 影片軌、圖片軌、字幕軌的軌道數每種均限制最多 100 個。

    • 素材總數不能超過 200 個，素材檔案總大小不能超過 1 TB。

    • 輸入或輸出 Bucket 所在 Region，必須和使用 VOD 服務的 Region 保持一致。

    • 當輸出為影片時，成片解析度有以下限制：

      • 寬高都不能小於 128px。

      • 寬高都不能大於 4096px。

      • 短邊不能大於 2160px。

    • 影片合成完成後，會自動上傳到影片點播中，因此，影片合成完成之後，點播服務會發送媒體合成完成和影片上傳完成的事件通知。合成影片轉碼完成後，會發送影片單一清晰度轉碼完成和影片全部清晰度轉碼完成的事件通知。

    • 您還可以為合成影片新增特效。更多詳情，請參見特效。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:ProduceEditingProjectVideo

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ProjectId

    string

    否

    雲端剪輯專案 ID。可透過以下方式獲取：

    fb2101bf24b4cb318787dc****
    Timeline

    string

    否

    雲端剪輯專案時間線，JSON 格式。具體結構定義，請參見 Timeline 。

    說明

    請確保每個 VideoTrackClip 物件中都包含有效的 MediaId，否則會導致請求失敗。

    {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]}
    Title

    string

    否

    雲端剪輯專案標題。

    Cloud Clip Project Title
    Description

    string

    否

    雲端剪輯專案描述。

    Cloud clip project description
    CoverURL

    string

    否

    雲端剪輯專案封面。

    https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png
    MediaMetadata

    string

    否

    合成影片的中繼資料，JSON 格式。具體結構定義，請參見 MediaMetadata 。

    {"Description":"Synthetic Video Description","Title":"Synthetic userData test"}
    ProduceConfig

    string

    否

    合成設定，JSON 格式。具體結構定義，請參見 ProduceConfig 。

    重要 StorageLocation 欄位在檔案儲存地域為上海時，可以忽略；在檔案儲存地域為其他地域時，為必填項。

    {"TemplateGroupId":"6d11e25ea30a4c465435c74****"}
    UserData

    string

    否

    自訂設定，為 JSON 字串，最大允許 256 個字元，支援訊息回呼等設定。具體結構定義，請參見 UserData 。

    說明

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

    {"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}
    AppId

    string

    否

    應用程式 ID。預設取值：app-1000000。使用說明，請參見多應用。

    app-****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

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

    string

    合成的影片 ID。

    說明

    • 影片合成介面同步返回合成的影片 ID。

    • 介面返回 MediaId，表示影片合成已進入非同步處理階段。

    006204a11bb386bb25491f95f****
    ProjectId

    string

    雲端剪輯專案 ID。

    fb2101bf24b4cb318787dc****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "MediaId": "006204a11bb386bb25491f95f****",
  "ProjectId": "fb2101bf24b4cb318787dc****"
}

    錯誤碼

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

    變更歷史

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