全部產品
Search
文件中心

Intelligent Media Services:SubmitBatchMediaProducingJob - 批量智能一鍵成片

更新時間:Mar 21, 2026

將多個視頻、音頻、圖片素材進行智能混剪,一鍵批量合成視頻。

介面說明

  • 智能一鍵成片提供【指令碼化自動成片】、【智能圖文匹配成片-通用情境版】、【智能圖文匹配成片-影視集錦版】、【體育賽事集錦成片】、【高燃混剪成片】等多種解決方案,功能詳情請參見智能一鍵成片

  • 指令碼化自動成片與智能圖文匹配成片共用同一個提交任務 API。有關如何通過參數區分這兩者,請參見智能一鍵成片參數區別說明

  • 提交批量智能一鍵成片任務後,您可以調用 ListBatchMediaProducingJob 擷取所有合格一鍵成片工作清單。調用 GetBatchMediaProducingJob 擷取任務詳細資料,包括任務的狀態、合成的媒資 ID 及 URL 等。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:SubmitBatchMediaProducingJob

create

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

ClientToken

string

調用方保證請求等冪性 Client Token

****12e8864746a0a398****

InputConfig

string

輸入配置。具體結構定義,請參見 InputConfig 配置說明。

{ "MediaGroupArray": [{ "GroupName": "MediaGroup1", "MediaArray": [ "****9d46c886b45481030f6e****", "****6c886b4549d481030f6e****" ] }, { "GroupName": "MediaGroup2", "MediaArray": [ "****d46c886810b454930f6e****", "****4549d886810b46c30f6e****" ] }], "TitleArray": [ "回龍觀盒馬鮮生開業啦", "盒馬鮮生開業啦" ], "SpeechTextArray": [ "附近的商場新開了一家盒馬鮮生,今天是第一天開業" "商場裡的人不少,零食、酒水都比較便宜大家也快來看看呀" ] }

EditingConfig

string

剪輯相關配置。具體結構定義,請參見 EditingConfig 配置說明。

{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }

OutputConfig

string

輸出配置。具體結構定義,請參見 OutputConfig 配置說明。

{ "MediaURL": "http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4", "Count": 20, "MaxDuration": 15, "Width": 1080, "Height": 1920, "Video": {"Crf": 27} }

UserData

string

使用者業務配置、回調配置。具體結構定義,請參見 UserData 配置說明

{"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}

TemplateConfig

string

模版參數。支援配置多個一鍵成片模版,隨機選取應用。詳情見 TemplateConfig 參數說明

["****b4549d46c88681030f6e****","****549d46c88b4681030f6e****"]

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

****36-3C1E-4417-BDB2-1E034F****

JobId

string

批量智能一鍵成片作業 ID

****d80e4e4044975745c14b****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "JobId": "****d80e4e4044975745c14b****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情