調用SubmitBatchMediaProducingJob介面提交批量智能一鍵成片任務-智能媒體服務-阿里雲 - Intelligent Media Services

介面說明

智慧一鍵成片為非同步介面，提交任務後返回任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過取得批次智慧一鍵成片任務資訊主動查詢任務狀態。
智慧一鍵成片提供【腳本化自動成片】、【智慧圖文匹配成片-通用場景版】、【智慧圖文匹配成片-影視集錦版】、【體育賽事集錦成片】、【高燃混剪成片】等多種解決方案，功能詳情請參見智慧一鍵成片。
腳本化自動成片與智慧圖文匹配成片共用同一個提交任務 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"} or {"NotifyAddress":"https://xx.xx.xxx"} or {"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****"
}

錯誤碼

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

變更歷史

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