高燃混剪成片的API參數說明 - Intelligent Media Services

本文旨在介紹高燃混剪成片的合成參數。

重要

注意：在此介面中，所有媒資的OSS URL中的地區（region）必須與調用OpenAPI服務地址中的地區（region）保持一致。
支援的地區：華東2（上海）、華北2（北京）、華東1（杭州）、華南1（深圳）、美國（西部）、新加坡。其中動作標籤識別的能力（對應參數為EnableActionRecog和CustomActions）僅支援華東2（上海）地區。
目前的版本暫不支援輸入不含人聲的視頻素材，請您務必仔細甄別視頻素材是否符合此條件。
在實際使用過程中，請將文檔所有參數樣本中的 [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path]、媒資ID（例如：“****9d46c8b4548681030f6e****”）等參數替換為您的實際值。

使用說明

將多個視頻素材進行高燃混剪，一鍵批量合成視頻介面說明，請參見SubmitScreenMediaHighlightsJob - 提交高燃混剪任務，API關鍵參數詳見下文InputConfig 參數說明、EditingConfig 參數說明、OutputConfig 參數說明。
擷取批量智能一鍵成片作業的詳細資料，請參見GetBatchMediaProducingJob - 擷取批量智能一鍵成片任務資訊。

InputConfig 參數說明

使用者可通過配置InputConfig，指定視頻素材、口播、背景音樂、貼紙等基礎素材的參數配置。

參數	類型	說明	樣本值	是否必填
MediaArray	List<String>	影視劇素材，僅可使用視訊。支援傳入媒資ID或素材OSS URL列表，視頻總時間長度最多兩小時，數量上限30個。素材支援的格式詳見視頻格式。重要暫不支援輸入不含字幕和人聲的視頻素材	詳見參數樣本	是
HighlightStrategy	HighlightStrategy	高燃混剪策略。	詳見參數樣本	否
OpeningArray	List<Media>	固定標題，每次合成隨機選一個，支援傳入媒資ID或素材OSS URL列表，數量上限20。素材支援圖片、視頻，格式詳見視頻格式、圖片格式。	詳見參數樣本	否
EndingArray	List<Media>	固定片尾，每次合成隨機選一個，支援傳入媒資ID或素材OSS URL列表，數量上限20。素材支援圖片、視頻，格式詳見視頻格式、圖片格式。	詳見參數樣本	否
TitleArray	List<String>	標題，最多50個，每次合成隨機選一個，每個標題不超過50字	["回龍觀盒馬鮮生開業啦","盒馬鮮生開業啦"]	否
SubHeadingArray	List<SubHeading>	副標題，最多5級。	詳見參數樣本	否
StickerArray	List<Sticker>	貼紙數組，每次合成隨機選一個。最多50個，支援媒資ID 或 OSS URL。隨機規則：假設傳入10個貼紙，成片數量設定為20。首先，隨機產生一個1至10之間的數字，例如3，然後按照3、4、5、6、7、8、9、10、1、2、3、4、5、6、7...的順序選擇貼紙。素材支援的格式詳見圖片格式。	詳見參數樣本	否
BackgroundMusicArray	List<String>	背景音樂數組，每次合成隨機選一個。最多50個，支援媒資ID 或 OSS URL。隨機規則：假設傳入10個背景音樂，成片數量設定為20。首先，隨機產生一個1至10之間的數字，例如3，然後按照3、4、5、6、7、8、9、10、1、2、3、4、5、6、7...的順序選擇背景音樂。素材支援的格式詳見音頻格式	詳見參數樣本	否
BackgroundImageArray	List<String>	背景圖片數組，每次合成隨機播放一個。最多50個，支援媒資ID 或 OSS URL。隨機規則：假設傳入10張背景圖，成片數量設定為20。首先，隨機產生一個1至10之間的數字，例如3，然後按照3、4、5、6、7、8、9、10、1、2、3、4、5、6、7...的順序選擇背景圖。素材支援的格式詳見圖片格式	詳見參數樣本	否

HighlightStrategy 參數說明

參數	資料類型	說明	樣本值	是否必填
IntroConfig	JSON	高燃部分的開頭配置 Mode: 選模數式，預設為Disabled Auto: 自動選取最高能片段作為開頭 Disabled：不額外添加開頭	{"Mode":"Disabled"}	否
TargetDurationConfig	TargetDurationConfig	成片時間長度配置	{"TargetDuration": 180, "SpeedRange": [0.95, 1]}	否
PlotPacingType	String	高燃部分的劇情節奏，該參數僅在ThemeConfig.ThemeType=JumpHighlight時生效取值範圍：慢：Slow 中等：Normal 快：Fast	Slow	否，預設Normal
ThemeConfig	ThemeConfig	剪輯主題相關配置	{"ThemeType":"JumpHighlight" }	否
HighlightDescription	String	高光提取策略描述。僅在ThemeConfig.ThemeType=SmoothHighlight時生效	優先選取具備以下特徵的情境。情緒外化明顯：男主XXX通過動作直接表達強烈情緒，如憤怒、守護或逆襲（如男主XXX與大哥之間的“較勁”）；反差感強烈：通過行為或身份的反差傳遞內在衝突（如權力爭奪、情感張力）；劇情衝突集中：圍繞主角的核心矛盾展開，如家族對抗、身份偽裝等，提升觀眾代入感；戲劇性情節突出：包含離奇對話或轉折事件（如“女扮男裝被認出”），增強吸引力和話題度。	否
FaceInfo	FaceInfo	設定人臉資訊有助於識別人物角色。如果希望在高光中儘可能多地展示某些角色，建議配置此參數。僅在ThemeConfig.ThemeType=SmoothHighlight時生效	{"ImageInfoList":[{"Name":"寧X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]}	否
EnableActionRecog	Boolean	是否開啟動作識別。開啟後，將結合動作識別結果進行高光片段的選擇。說明動作識別僅支援華東2（上海）地區	true	否。預設false
CustomActions	List<String>	自訂動作標籤，優先按照傳入的標籤名稱做映射。例如： ["打鬥","哭泣"]。數組長度上限為50，每個標籤字元上限為5。說明動作識別僅支援華東2（上海）地區	["打鬥","哭泣"]	否

ThemeConfig 參數說明

參數	資料類型	說明	樣本值	是否必填
ThemeType	String	JumpHighlight：劇情跳剪。挑選出多個高光片段，按照從頭到尾的順序進行串接剪輯。該類型的成片可能存在劇情跳躍，適合用於純高燃集錦的串剪情境，當前一次任務只能產生一個成片。 SmoothHighlight：劇情順剪。挑選出多個高光片段作為開頭，然後分別從這多個標題開始向後開始截取TargetDuration時間長度的原片（會進行自動片段去重、標題片尾刪減）進行成片。該類型的成片劇情相對較為連貫，並且能夠一次性產生多個成片。	SmoothHighlight	否，預設JumpHighlight

TargetDurationConfig 參數說明

參數

資料類型

說明

樣本值

是否必填

TargetDuration

Float

高燃部分（不包括固定的標題、片尾及高燃部分的開頭）的期望總時間長度，單位：秒。可能會存在一定的波動。如不填寫，將根據劇情自動適配時間長度。
取值範圍大於等於5秒，小於等於素材總時間長度。

180

否

SpeedRange

List<String>

變速範圍設定。

如果期望成片能夠以固定值進行變速，可以將變速範圍的起始值和結束值設定為相同，例如[1.2, 1.2]，則會以1.2倍的速率進行變速。

如果期望實際成片的時間長度儘可能與目標時間長度TargetDuration一致，可以通過設定可接受的“變速範圍”來實現，樣本如下：

假設TargetDuration為10，SpeedRange為[0.95,1]，則通過SpeedRange計算得出的實際可接受的變速時間長度為[10,10.526]秒。實際成片時間長度的計算邏輯如下：
- 如果實際成片時間長度為10.5秒，則在可接受範圍[10,10.526]內，此時按（10/10.5）≈0.9524倍速進行變速處理，最終成片時間長度為10秒。
- 如果實際成片時間長度為11秒，則需按照SpeedRange的下限值0.95倍進行變速，因此最終成片時間長度為11秒乘以0.95，最終成片時間長度=10.45秒。

[0.95, 1]

否

FaceInfo 參數說明

參數	類型	說明	是否必填
ImageInfoList	List<ImageInfo>	人物（人臉）照片列表，列表長度上限200。	否

ImageInfo 參數說明

參數	類型	說明	樣本值	是否必填
Name	String	人物（人臉）名稱	丹尼爾	是
ImageURL	String	人物（人臉）照片儲存地址，需要是公網可訪問的URL連結。請確保人臉圖片中僅包含一名個體，並且人臉應清晰可見，無明顯遮擋或缺失現象。	http://[your-cdn-domain]/[your-file-path]/face1.png	是，二選一必填
ImageId	String	圖片媒資ID	**9d46c886b45481030f6e**	是，二選一必填

Media 參數說明

參數	資料類型	說明	樣本值	是否必填
MediaId	String	媒資ID	**b4549dfvc88681030f6e**	二選一必填都填寫時優先取用MediaId
MediaURL	String	媒資URL，僅支援自有OSS	規則：http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 樣本：http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4	二選一必填都填寫時優先取用MediaId
In	Float	當素材為視頻時，表示素材入點，單位：秒。	0	否
Out	Float	當素材為視頻時，表示素材出點，單位：秒。	5	否
Duration	Float	當素材是圖片時，表示素材展示的時間長度，單位：秒。	2	否
DyncFrames	Integer	當素材為gif格式時，表示動圖的幀數	25	否

參數樣本

劇情順剪

{
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"
    },
    "TargetDurationConfig": {
      "TargetDuration": 300
    },
    "ThemeConfig": {
      "ThemeType": "SmoothHighlight"
    },
    "HighlightDescription":"優先選取具備以下特徵的情境。情緒外化明顯：男主XXX通過動作直接表達強烈情緒，如憤怒、守護或逆襲（如男主XXX與大哥之間的“較勁”）；反差感強烈：通過行為或身份的反差傳遞內在衝突（如權力爭奪、情感張力）；劇情衝突集中：圍繞主角的核心矛盾展開，如家族對抗、身份偽裝等，提升觀眾代入感；戲劇性情節突出：包含離奇對話或轉折事件（如“女扮男裝被認出”），增強吸引力和話題度。",
    "FaceInfo":{"ImageInfoList":[{"Name":"寧X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]},
    "EnableActionRecog": true,
    "CustomActions": ["打鬥","哭泣"]
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "回龍觀盒馬鮮生開業啦",
    "盒馬鮮生開業啦"
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "副標題1",
        "副標題2"
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "三級副標題"
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
  ]
}

劇情跳剪

{
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"
    },
    "ThemeConfig": {
      "ThemeType": "JumpHighlight"
    },
    "EnableActionRecog": true,
    "CustomActions": ["打鬥","哭泣"]
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "回龍觀盒馬鮮生開業啦",
    "盒馬鮮生開業啦"
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "副標題1",
        "副標題2"
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "三級副標題"
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
  ]
}

EditingConfig 參數說明

使用者可通過配置EditingConfig，指定成片素材的音量、位置及其他合成參數。

參數	類型	說明	樣本值	是否必填
MediaConfig	JSON	輸入視頻素材相關配置。	詳見參數樣本	否
TitleConfig	JSON	標題相關配置，支援配置字幕參數。	詳見參數樣本	否
SubHeadingConfig	JSON	多級副標題相關配置。支援設定字幕參數。 JSON欄位說明： key：Level value：橫幅文字	詳見參數樣本	否
BackgroundMusicConfig	JSON	背景音樂相關配置。	詳見參數樣本	否
BackgroundImageConfig	JSON	背景圖相關配置。如果InputConfig中已配置背景圖，則此欄位不生效。	詳見參數樣本	否
ProcessConfig	JSON	混剪處理配置。	詳見參數樣本
FECanvas	JSON	用於前端頁面預覽時的畫布配置。	{"Width": 1080,"Height": 1920}	否
ProduceConfig	JSON	普通剪輯合成配置，欄位詳見：EditingProduceConfig	{"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"xxxd54a97cff4108b555b01166d4bxxx","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false}	否

ProcessConfig 參數說明

參數	類型	說明	樣本值	是否必填
AllowVfxEffect	Boolean	是否允許添加特效效果。	true	否，預設false
VfxEffectProbability	Float	特效應用在每個視頻片段上的機率，取值：0.0 - 1.0，支援2位小數。	0.6	否，預設0.5
VfxFirstClipEffectList	List<String>	當VfxFirstClipEffectList不為空白時，成片的第一個片段的特效將從VfxFirstClipEffectList中選擇。當VfxFirstClipEffectList為空白時，成片第一個片段的特效將從以下特效中隨機播放："slightshow"、"starfieldshinee"、"starfieldshinee2"、"starsparkle"、"colorfulripples"、"starfield"。特效樣本詳見：特效效果樣本	["slightshow","starfieldshinee"]	否
VfxNotFirstClipEffectList	List<String>	當VfxNotFirstClipEffectList不為空白時，成片中非第一個片段的特效將從VfxNotFirstClipEffectList中進行選擇。當VfxNotFirstClipEffectList為空白時，成片非第一個片段的特效將從以下特效中選擇："zoomslight"、"zoom"、"zoominout"、"slightshake"。特效樣本詳見：特效效果樣本	["zoomslight","zoom"]	否
AllowTransition	Boolean	是否允許添加轉場效果。	true	否，預設false
TransitionDuration	Float	轉場時間長度，單位秒。如果轉場時間長度 > 片段時間長度 - 1，則該片段上的轉場效果不會生效。	0.5	否，預設0.5秒
TransitionList	List<String>	自訂轉場效果列表，當AllowTransition=true時，隨機選取列表中的一個轉場效果進行合成。轉場效果的可選範圍詳見轉場效果庫。如果此參數為空白，則會從以下轉場效果中隨機選取："linearblur", "colordistance", "crosshatch", "dreamyzoom", "doomscreentransition_up"	["directional", "linearblur"]	否
UseUniformTransition	Boolean	單個成片中是否使用一致的轉場效果。	true	否，預設true
AllowFilter	Boolean	是否允許添加自訂濾鏡。	false	否，預設false
FilterList	List<String>	自訂濾鏡效果列表，當AllowFilter=true時，隨機選取列表中的一個濾鏡進行合成，濾鏡效果的可選範圍濾鏡效果樣本，如果此參數為空白，則不會添加濾鏡效果。	["m1", "m2"]	否

參數樣本

{
  "MediaConfig": {
    "Volume": 0 // 預設視頻素材靜音
  },
  "TitleConfig": {
    "Alignment": "TopCenter",
    "AdaptMode": "AutoWrap",
    "Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
    "SizeRequestType": "Nominal",
    "Y": 0.1, // 成片為豎屏時，標題Y座標值
    "Y": 0.05, // 成片為橫屏時，標題Y座標值
    "Y": 0.08 // 成片為方屏時，標題Y座標值
  },
   "SubHeadingConfig": {
    "1": {
      "Y": 0.3,
      "FontSize": 40
    },
    "3": {
      "Y": 0.5,
      "FontSize": 30
    }
  },
  "BackgroundMusicConfig": {
    "Volume": 0.2,   // 背景音樂預設用20%音量,
    "Style": null
  },
  "ProcessConfig": {
    "AllowVfxEffect": false,	  // 是否添加特效效果
    "AllowTransition": false,	  // 是否添加轉場效果
  }
}

TemplateConfig 參數說明

TemplateConfig為一鍵成片的公用參數，用於設定一鍵成片模板。詳細參數說明和使用樣本詳見TemplateConfig 參數說明

OutputConfig 參數說明

使用者可通過配置OutputConfig，指定成片輸出地址、名稱規則、成片的寬高、輸出成片數量等合成參數。

參數	類型	說明	樣本值	必填
MediaURL	String	輸出視頻地址，必須要有預留位置{index}。	規則：http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 樣本：http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4	當GeneratePreviewOnly=false時，且成片輸出到OSS時必填
StorageLocation	String	指定輸出到VOD的媒資檔案儲存體地址。	規則：[your-vod-bucket].oss-[your-region-id].aliyuncs.com 樣本：outin-**6c886b4549d481030f6e**.oss-cn-shanghai.aliyuncs.com	當GeneratePreviewOnly=false時，且成片輸出到VOD時必填
FileName	String	輸出檔案名稱，必須要有預留位置{index}。	規則：[your-file-name]__{index}.mp4 樣本：example_{index}.mp4	當GeneratePreviewOnly=false時，且成片輸出到VOD時必填
GeneratePreviewOnly	Boolean	GeneratePreviewOnly = true時，表示當前任務僅產生預覽用的時間軸，不實際合成，可不填寫輸出視頻的地址。一鍵成片任務完成後，通過GetBatchMediaProducingJob查詢任務結果，返回的子任務列表中會包含剪輯工程projectId，再調用GetEditingProject可擷取到預覽時間軸。	false	否，預設false
Count	Integer	輸出視頻數。當ThemeConfig.ThemeType=JumpHighlight時，Count只能為1 當ThemeConfig.ThemeType=SmoothHighlight時，產生的成片數量小於或等於Count，實際成片個數與高光片段數量有關。Count取值範圍[1,100]	1	否，預設1
Width	Integer	成片寬，px	1080	是
Height	Integer	成片高，px	1920	是
Video	JSONObject	輸出視頻流相關配置，Crf、Codec等	{"Crf": 27}	否

參數樣本

{
 	"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name]_{index}.mp4",
 	"Count": 1,
 	"Width": 1080,
 	"Height": 1920,
 	"Video": {"Crf": 27},
        "GeneratePreviewOnly":false
}

處理邏輯

根據MediaArray配置剪輯素材，對素材進行分析時應按照素材的順序進行處理。
根據HighlightStrategy配置高燃集錦部分的標題和片尾。
根據OpeningArray和EndingArray來配置高燃集錦部分之前的固定開頭（前貼片）、之後的固定結尾（後貼片）。
一鍵成片API中的配置參數優先順序高於模板中設定的參數。如果您已配置TemplateConfig，則會優先從一鍵成片任務API中讀取不允許為 NULL 的參數，對於為空白的部分參數，則將從模板中讀取。

Intelligent Media Services：高燃混剪成片

使用說明

InputConfig 參數說明

HighlightStrategy 參數說明

ThemeConfig 參數說明

TargetDurationConfig 參數說明

FaceInfo 參數說明

ImageInfo 參數說明

Media 參數說明

參數樣本

劇情順剪

劇情跳剪

EditingConfig 參數說明

ProcessConfig 參數說明

參數樣本

TemplateConfig 參數說明

OutputConfig 參數說明

參數樣本

處理邏輯

相關文檔