Intelligent Media Services：SubmitMediaProducingJob - 提交剪輯合成作業

• 計費說明：視訊剪輯按照剪輯合成的成片時間長度計費，詳情請參見視訊剪輯。若處理失敗，不收取費用。

• 多樣化剪輯能力：當您需要將素材按照個人化創意進行編排和設計時，您需要調用該介面，該介面支援通過靈活的 Timeline 配置，實現複雜的視訊剪輯需求。

• 素材引用規則：雲剪輯時間軸中引用的素材，既可以是素材庫中的媒資，也可以直接引用 OSS 檔案，暫不支援外部地址或 CDN 地址。當素材為 OSS 檔案時，MediaUrl 僅支援 OSS 地址格式，如：https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext。

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

• 任務狀態查詢：

  1. 調用 GetMediaProducingJob ，通過傳入 JobId 查詢任務狀態和結果。

  2. 在提交剪輯合成作業時，您可以在請求參數中設定 UserData，將其包含回調地址。當剪輯任務完成或失敗時，系統會向該回調地址發送通知，您可以通過處理回調資料來瞭解任務的狀態。

• 媒資註冊與分析：視頻合成完成後，會自動註冊媒資，此時媒資還是分析中狀態，當媒資分析完成後，可以根據 MediaId 擷取成片時間長度及解析度資訊。

使用限制

• 該介面的流量控制值為 30 QPS（每秒提交任務的請求數）。提交的任務會進入後台排隊，以非同步方式處理。

  說明

  如果超出此限制，可能會遇到 "Throttling.User" 錯誤。詳情請參見： 提交剪輯任務時遇到“Throttling.User”錯誤。

• 提交大量任務（如 1000 條、10000 條）時，系統會動態擴容，但可能會有一定排隊時間。

• 視頻軌、圖片軌、字幕軌的軌道數每種均限制最多 100 個。

• 素材個數無限制，素材檔案總大小不能超過 1 TB。

• 輸入或輸出 OSS Bucket 所在 Region，必須和使用 IMS 的 Region 保持一致。

• 當輸出為視頻時，成片解析度有以下限制：

  • 寬高都不能小於 128 px。

  • 寬高都不能大於 4096 px。

  • 短邊不能大於 2160 px。

OutputMediaConfig 參數樣本

樣本：輸出到 OSS

{
  "MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

當輸出到 OSS 時，MediaURL 必填。OutputMediaTarget 參數預設值為 "oss-object", 表示輸出到 OSS。 其他參數可以選填，其中 Bitrate 用來設定輸出成品的碼率，通常碼率越高越清晰，最大可以設定到 5000。 Width, Height 用來設定成品的解析度。

OSS URL 的路徑格式： https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname 是 OSS Bucket 的名稱。

oss-region-name.aliyuncs.com 是 OSS 檔案的外網 Endpoint，比如上海，北京，杭州的分別是：

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

樣本：輸出到 vod

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

當輸出到 VOD 時， StorageLocation 和 FileName 兩個參數必填。OutputMediaTarget 參數設定為 "vod-media", 表示輸出到點播 VOD 的儲存 Bucket。點播 VOD 可以使用的儲存位置可以在 VOD 裡面上傳媒資後，在媒資的儲存地址中看到。

OutputMediaConfig 結構中的參數說明