全部產品
Search

搜尋本產品

    ：ProduceEditingProjectVideo - 視頻合成

    文件中心

    ：ProduceEditingProjectVideo - 視頻合成

    更新時間：Dec 12, 2025

    將一個或多個視頻合成為成品。可以通過時間軸參數直接提交源視頻，也可以先建立雲剪輯工程，再提交合成。

    介面說明

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

    • 該介面返回合成任務的提交結果，不保證介面返回時視頻已合成完畢。合成任務將進入後台排隊，非同步執行。

    • 雲剪輯時間軸所使用的視頻資源，既可以是素材管理中的素材，也可以是媒體庫中的視頻，使用媒體庫中的視頻需要確保其狀態為正常（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。

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

    • 您還可以為合成視頻添加特效。更多詳情，請參見特效。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:ProduceEditingProjectVideo

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    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****"
}

    錯誤碼

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

    變更歷史

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