全部產品
Search

搜尋本產品

    Intelligent Media Services：AddTemplate - 建立模板

    文件中心

    Intelligent Media Services：AddTemplate - 建立模板

    更新時間：Mar 21, 2026

    智能生產製作支援基於普通模板和進階模板的視訊剪輯功能，使用者可調用AddTemplate建立模板。

    介面說明

    使用說明

    使用限制

    進階模板建立後有個解析的時間，狀態為 Processing，此時模板不可用，當模板狀態為 Available 方可使用。模板解析時間與模板檔案大小有關，一般 10s-5min。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:AddTemplate

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    否

    自訂模板名稱。

    模板名稱
    Type

    string

    否

    模板類型，目前支援：

    • Timeline（普通模板）：基於視訊剪輯工程的 Timeline（時間軸內多個素材，多圖層形式進行前後拼接）建立的模板，可實現圖文轉視頻、圖片相簿、標題片尾、預設浮水印等效果。

    • VETemplate（進階模板）：基於 AE（Adobe After Effects）特效建立的模板，可實現複雜動效樣式的進階媒體效果。

    • BatchEditing (一鍵成片模版)：支援配置貼紙浮水印、背景音樂、背景圖片、口播字幕樣式、標題字幕樣式、輸出解析度等參數，提交一鍵成片任務時自動應用。

    枚舉值：

    • Timeline :

      普通模板

    • VETemplate :

      進階模板

    Timeline
    Config

    string

    否

    參見Timeline模板Config文檔
    CoverUrl

    string

    否

    模板封面

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
    PreviewMedia

    string

    否

    模板預覽視頻 MediaId

    ****01bf24bf41c78b2754cb3187****
    Status

    string

    否

    模板狀態，取值範圍：

    • Available：正常

    • Created：已建立還不能使用

    • Uploading：上傳中

    • Processing：進階模板分析中

    • UploadFailed：上傳失敗

    • ProcessFailed：進階模板分析失敗

    枚舉值：

    • UploadFailed :

      上傳失敗

    • ProcessFailed :

      進階模板分析失敗

    • Available :

      正常

    • Uploading :

      上傳中

    • Created :

      已建立，還不能使用

    • Processing :

      進階模板分析中

    Available
    Source

    string

    否

    模板建立來源，取值範圍：

    • OpenAPI：通過 OpenAPI 建立

    • AliyunConsole：通過阿里雲控制台建立

    • WebSDK：通過 WebSDK 建立

    枚舉值：

    • AliyunConsole :

      通過阿里雲控制台建立

    • WebSDK :

      通過 WebSDK 建立

    • OpenAPI :

      通過 OpenAPI 建立

    OpenAPI
    RelatedMediaids

    string

    否

    模板關聯素材，普通模板編輯器使用

    {"video":["1805a0c6ca544fb395a06ca683619655"]}

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    Id of the request

    ****2876-6263-4B75-8F2C-CD0F7FCF****
    Template

    object

    模板資訊

    TemplateId

    string

    模板 Id

    ****01bf24bf41c78b2754cb3187****
    Name

    string

    模板名稱

    模板名稱
    Type

    string

    模板類型

    枚舉值：

    • Timeline :

      普通模板

    • VETemplate :

      進階模板

    Timeline
    Config

    string

    參見 Timeline 模板 Config 文檔

    參見Config文檔
    CoverUrl

    string

    模板封面

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
    PreviewMedia

    string

    預覽視頻媒資 id

    ****01bf24bf41c78b2754cb3187****
    Status

    string

    模板狀態

    枚舉值：

    • UploadFailed :

      上傳失敗

    • ProcessFailed :

      進階模板分析失敗

    • Available :

      正常

    • Uploading :

      上傳中

    • Created :

      已建立，還不能使用

    • Processing :

      進階模板分析中

    Available
    CreateSource

    string

    模板建立來源

    枚舉值：

    • AliyunConsole :

      通過阿里雲控制台建立

    • WebSDK :

      通過 WebSDK 建立

    • OpenAPI :

      通過 OpenAPI 建立

    OpenAPI
    ModifiedSource

    string

    模板修改來源

    枚舉值：

    • AliyunConsole :

      通過阿里雲控制台建立

    • WebSDK :

      通過 WebSDK 建立

    • OpenAPI :

      通過 OpenAPI 建立

    OpenAPI

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "****2876-6263-4B75-8F2C-CD0F7FCF****",
  "Template": {
    "TemplateId": "****01bf24bf41c78b2754cb3187****",
    "Name": "模板名稱",
    "Type": "Timeline",
    "Config": "參見Config文檔",
    "CoverUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
    "PreviewMedia": "****01bf24bf41c78b2754cb3187****",
    "Status": "Available",
    "CreateSource": "OpenAPI",
    "ModifiedSource": "OpenAPI"
  }
}

    錯誤碼

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

    變更歷史

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