AI 助理
备案控制台登录注册
文档
输入文档关键字查找
首页智能媒体服务实践教程视频自动制作典型场景案例批量智能一键成片参数说明高燃混剪成片

高燃混剪成片

更新时间：2025-04-07 05:21:02
产品详情
我的收藏

本文旨在介绍高燃混剪成片的合成参数。

重要

  • 注意：在此接口中，所有媒资的OSS URL中的区域（region）必须与调用OpenAPI服务地址中的区域（region）保持一致。

  • 支持的区域：华东2（上海）、华北2（北京）、华东1（杭州）、华南1（深圳）、美国（西部）、新加坡。

  • 当前版本暂不支持输入不含字幕且不含人声的视频素材，请您务必仔细甄别视频素材是否符合此条件。

  • 在实际使用过程中，请将文档所有参数示例中的 [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path]、媒资ID（例如：“****9d46c8b4548681030f6e****”）等参数替换为您的实际值。

使用说明

InputConfig 参数说明

用户可通过配置InputConfig，指定视频素材、口播、背景音乐、贴纸等基础素材的参数配置。

参数

类型

说明

示例值

是否必填

MediaArray

List<String>

影视剧素材，仅支持视频。支持传入媒资ID或素材OSS URL列表，视频总时长最多两小时，数量上限20个。

详见参数示例

是

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个。

详见参数示例

否

BackgroundMusicArray

List<String>

背景音乐，每次合成随机选一个。

最多50个，支持媒资ID 或 OSS URL。

详见参数示例

否

BackgroundImageArray

List<String>

背景图片，每次合成随机选择一个。

最多50个，支持媒资ID 或 OSS URL。

详见参数示例

否

HighlightStrategy 参数说明

参数

数据类型

说明

示例值

是否必填

IntroConfig

JSON

高燃部分的开头配置

  • Mode: 选取模式，默认为Disabled

    • Auto: 自动选取最高能片段作为开头

    • Disabled：不额外添加开头

{"Mode":"Disabled"}

否

TargetDuration

Float

  • 高燃部分（不包括固定的片头、片尾及高燃部分的开头）的期望总时长，单位：秒。可能会存在一定的波动。如不填写，将根据剧情自动适配时长。

  • 取值范围大于等于5秒，小于等于素材总时长。

180

否

PlotPacingType

String

  • 高燃部分的剧情节奏，取值范围：

    • 慢：Slow

    • 中等：Normal

    • 快：Fast

Slow

否，默认Normal

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

In

Float

当素材为视频时，表示素材入点，单位：秒。

0

否

Out

Float

当素材为视频时，表示素材出点，单位：秒。

5

否

Duration

Float

当素材是图片时，表示素材展示的时长，单位：秒。

2

否

DyncFrames

Integer

当素材为gif格式时，表示动图的帧数

25

否

参数示例

{
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"
    }
  },
  "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字段说明：

详见参数示例

否

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

AllowTransition

Boolean

是否允许添加转场效果。

true

否，默认false

TransitionDuration

Float

转场时长，单位秒。如果转场时长 > 片段时长 - 1，则该片段上的转场效果不会生效。

0.5

否，默认0.5秒

TransitionList

List<String>

自定义转场效果列表，当AllowTransition=true时，随机选取列表中的一个转场效果进行合成。转场效果的可选范围详见转场效果库。如果传此参数null，则会从以下转场效果中随机选取："linearblur", "colordistance", "crosshatch", "dreamyzoom", "doomscreentransition_up"

["directional", "linearblur"]

否

UseUniformTransition

Boolean

单个成片中是否使用一致的转场效果。

true

否，默认true

参数示例

{
  "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=true时，且成片输出到OSS时必填

StorageLocation

String

指定输出到VOD的媒资文件存储地址。

规则：[your-vod-bucket].oss-[your-region-id].aliyuncs.com

示例：outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com

当GeneratePreviewOnly=true时，且成片输出到VOD时必填

FileName

String

输出文件名称，必须要有占位符{index}。

规则：[your-file-name]__{index}.mp4

示例：example_{index}.mp4

当GeneratePreviewOnly=true时，且成片输出到VOD时必填

GeneratePreviewOnly

Boolean

  • GeneratePreviewOnly = true时，表示当前任务仅生成预览用的时间线，不实际合成，可不填写输出视频的地址。

  • 一键成片任务完成后，通过GetBatchMediaPoducingJob查询任务结果，返回的子任务列表中会包含剪辑工程projectId，再调用GetEditingProject可获取到预览时间线。

false

否，默认false

Count

Integer

输出视频数，当前版本只能为1。

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中读取非空参数，对于为空的部分参数，则将从模板中读取。

相关文档

上一篇：体育赛事集锦成片下一篇：智能高光片段提取
  • 本页导读 （1）
  • 使用说明
  • InputConfig 参数说明
  • HighlightStrategy 参数说明
  • Media 参数说明
  • 参数示例
  • EditingConfig 参数说明
  • ProcessConfig 参数说明
  • 参数示例
  • TemplateConfig 参数说明
  • OutputConfig 参数说明
  • 参数示例
  • 处理逻辑
  • 相关文档
AI助理

点击开启售前

在线咨询服务

你好，我是AI助理

可以解答问题、推荐解决方案等