全部產品
Search

搜尋本產品

    Intelligent Media Services：AddTemplate

    文件中心

    Intelligent Media Services：AddTemplate

    更新時間：Aug 05, 2026

    智慧生產製作支援基於普通範本和進階範本的影片剪輯功能，使用者可呼叫 AddTemplate 建立範本。

    介面說明

    使用說明

    使用限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:AddTemplate

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    否

    自訂範本名稱。

    Template name
    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

    範本名稱。

    Template name
    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": "Template name",
    "Type": "Timeline",
    "Config": "参见Config文档",
    "CoverUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
    "PreviewMedia": "****01bf24bf41c78b2754cb3187****",
    "Status": "Available",
    "CreateSource": "OpenAPI",
    "ModifiedSource": "OpenAPI"
  }
}

    錯誤碼

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

    變更歷史

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