Intelligent Media Services：SubmitMediaProducingJob

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

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

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

• 非同步執行任務：- 該介面為非同步任務，提交任務後返回任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過查詢剪輯合成作業主動查詢任務狀態。

• 任務狀態查詢：

  1. 呼叫查詢剪輯合成作業，透過傳入 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 結構中的參數說明