You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
视频剪辑
视频快速混剪
复制全文
下载 pdf
视频快速混剪
将视频素材按幕顺序组合成多条短视频,适用于商品展示、营销投放、活动宣传等内容结构已明确、需要不同画面版本的场景。可以手动整理「吸引注意 → 展示卖点 → 引导下单」等幕结构,也可以选择自动或随机分幕。画面素材不保留原声,成片支持无声、合成旁白和现成旁白,有文案时提供普通字幕。​
算子介绍​
算子 ID:las_video_fast_remix​
适用场景​
​
​
场景​
描述​
商品展示​
按“开场—卖点—行动引导”等固定幕结构生成多版素材。​
营销投放​
自动或随机组合画面,快速生成不同剪辑方案。​
活动宣传​
使用文案、TTS 或现成旁白生成带字幕短视频。​
​
核心能力​
  • 三种分幕方式:支持 2~10 幕手动分幕、基于画面理解的自动分幕,以及无需素材理解的随机分幕。​
  • 声音与字幕:画面素材不保留原声;支持无声成片、TTS 合成旁白或一条现成旁白,有文案时提供逐句字幕。​
  • 多版本交付:单次任务最多生成 1000 条成片,并交付带/无字幕视频、SRT、分段视频、剪辑方案与完整结果 JSON。​
  • 外观与规格:可配置普通字幕样式及目标分辨率、帧率和严格校验。​
​
支持的地域​
  • 北京:cn-beijing​
算子性能​
​
​
细分项​
限制或说明​
耗时​
与素材数量、总时长、分幕方式、成片数量、TTS 和目标规格相关;自动分幕需增加画面理解耗时。​
​
输入与输出要求​
输入要求​
​
​
细分项​
详细要求​
支持的数据模态​
  • 视频​
  • 音频(现成旁白)​
  • 文本(文案与分幕要求)​
输入模态:视频​
  • 格式:mp4、mov、m4v、webm、mkv、avi。​
  • 数量与大小:​
  • 合计最多 30 条,单条最长 10 分钟。​
  • 自动分幕时,每条画面素材须大于 1 秒。​
  • 手动/自动每幕至少 1.2 秒;随机分幕每镜头至少 1 秒。​
输入模态:音频​
  • 格式:支持 mp3、wav、m4a、aac、flac、ogg。​
  • 数量:现成旁白最多 1 条。​
  • 其他要求:与 TTS 互斥且必须同时提供 script。​
输入模态:文本​
  • script 最多 4000 字符,与 10~60 秒的 target_duration_sec 二选一;​
  • 单幕 requirement 最多 200 字符。​
输入路径​
  • 公网 URL:使用 LAS 服务可直接访问的 HTTP/HTTPS 文件直链,不接受目录;使用签名 URL 时,有效期须覆盖任务排队和执行过程。​
  • TOS 路径:使用 tos://bucket/key 格式的具体文件地址,不接受目录。TOS Bucket 须与 LAS 服务属于同一主账号、同一地域,并授予 LAS 服务目标对象的读取权限。​
​
输出要求​
​
​
细分项​
详细要求​
支持的数据模态​
  • 视频​
  • 文本(SRT、剪辑方案和结果 JSON)​
输出模态:视频​
  • 最多返回 5 条成片;可包含带字幕视频、无字幕视频和分段视频。​
  • 默认目标规格为 1080×1920、60 FPS、非严格模式。​
输出模态:文本​
  • 返回字幕 SRT、剪辑方案 JSON 和完整结果 JSON;实际产物以 Poll 的 data.artifacts 为准。​
  • 分幕数:手动/自动 2~10 幕;随机模式按素材生成 1~10 幕。​
输出路径​
  • TOS 路径:​
  • 支持通过 output_tos_path 指定 tos://bucket/prefix 格式的输出目录。​
  • TOS Bucket 须与 LAS 服务属于同一主账号、同一地域,并授予 LAS 服务目标目录的写入权限。​
  • 不传 output_tos_path 时,由 LAS 分配输出位置。​
最终产物的 TOS 路径和临时访问 URL 以 Poll 的 data.artifacts 为准。​
​
计费说明​
  • 计费标准​
  • ​
  • ​
    细分项​
    计费标准说明​
    计费项​
    包含以下几个计费项:​
    • 混剪成片费用:进行快速混剪时,基于所有成功成片实际时长之和进行累计计费。同条带/无字幕版只计一次。​
    • 自动分幕费用(按需):当开启自动分幕时(请求参数 enable_auto_chaptering=true **** ),收取智能分幕费用,按画面素材原始时长累计计费,同一素材只计一次。​
    • 口播配音(TTS)费用:按生成口播配音的字数统计用量进行计费。未生成口播配音时不产生费用。​
    任务总费用为以上计费项费用之和。​
    计费类型​
    按量计费,按实际的计费用量每小时出账。计费精度:毫秒级、按比例、不满一分钟不补整。​
    单价​
    不同计费项的单价不同,详情如下。​
    ​
  • 计费详情​
  • ​
  • ​
    计费项​
    单价​
    混剪成片​
    0.4 元/分钟​
    自动分幕​
    0.4 元/分钟​
    口播配音​
    0.3 元/千字​
    ​
注意与前提​
​
​
细分项​
注意与前提​
开通 LAS​
  • 如果您是一个全新的火山引擎用户,此前未开通过 LAS 产品,您可先开通 LAS,不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。​
费用​
调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。​
鉴权(API Key)​
调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。​
BaseURL​
调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。​
详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。​
​
Rest API 调用​
API 调用说明​
通过 Submit 获取 task_id,再调用 Poll 查询。仅在任务完成且业务码为 0 时消费结果。​
Submit​
请求参数​
operator_id string 必选 示例值: las_video_fast_remix​
固定为 las_video_fast_remix。​
​
operator_version string 必选 示例值: v1​
固定为 v1。​
​
data FastRemixReqParams 必选​
acts list of FastRemixAct Conditional​
手动分幕候选池,2~10 幕,数组顺序即成片幕顺序。不传或为 null 时由 enable_auto_chaptering 选择自动或随机分幕。​
video_urls list of string 必选​
本幕至少一个具体视频文件;所有幕合计最多 30 条,支持 mp4、mov、m4v、webm、mkv、avi,单条不超过 10 分钟。​
​
requirement string Optional​
本幕画面定位要求,最多 200 字符。首幕默认按开场、末幕默认按 CTA 定位,中间幕不传则不精定位。​
​
duration_sec float Optional 示例值: 6​
固定幕时长,至少 1.2 秒;不传时由剩余时间分配。固定时长合计须适配总时间轴,并为其他幕各保留至少 1.2 秒。​
​
​
enable_auto_chaptering boolean Optional 示例值: false​
不传 acts 时,true 为自动分幕,false 为随机分幕;不能与 acts 同传。​
​
video_urls list of MaterialItem Conditional​
无 acts 时至少提供一条画面素材,最多 30 条;可使用地址字符串或对象。自动分幕时每条画面视频须大于 1 秒。手动模式画面放在 acts 中,此数组仅可放一条现成旁白。​
url string 必选 示例值: tos://your-bucket/product.mp4​
具体视频文件地址;voiceover 还接受 mp3、wav、m4a、aac、flac、ogg 音频。​
​
role string Optional 示例值: broll​
默认 speech。speech 与 broll 均只使用画面;voiceover 只使用声音,最多一条且必须同时提供 script。​
​
​
script string Conditional​
成片文案,最多 4000 字符,与 target_duration_sec 二选一。​
​
target_duration_sec integer Conditional 示例值: 30​
无文案时必填,范围 [10,60]。​
​
max_clips integer Optional 示例值: 5​
成片数量上限,范围 [1,1000],默认值为 5;实际成功条数可能少于该值。​
​
tts TtsParams Optional​
TTS 配置,与现成旁白互斥。​
enable boolean Optional 示例值: true​
默认 false;开启后根据 script 合成整片旁白,没有 script 时不能开启。​
​
language string Optional 示例值: zh​
支持 zh、en、id、ar、es、ja、ko;不传时按实际文案识别。​
​
voice string Optional​
TTS 音色 ID;须支持目标语言与所选情绪。​
​
speed float Optional 示例值: 1.25​
语速倍率,默认 1.25;显式 speech_rate 优先。​
​
speech_rate integer Optional 示例值: 0​
原生语速档,范围 [-50,100];-50 为 0.5 倍,0 为 1 倍,100 为 2 倍。​
​
loudness_rate float Optional 示例值: 0​
合成源音频音量档,范围 [-50,100],不是成片最终响度。​
​
emotion string Optional​
音色情绪,可用值由所选音色决定。​
​
emotion_scale float Optional 示例值: 3​
情绪强度,范围 [1,5]。​
​
​
subtitle_style SubtitleStyleParams Optional​
普通字幕样式。有文案时控制带字幕成片外观,无文案时不生效。​
font_size integer Optional 示例值: 50​
正文字号,范围 [24,120] px,以 720×1280 为基准。​
​
keyword_font_size integer Optional 示例值: 60​
关键词字号,范围 [24,120] px。​
​
text_color string Optional 示例值: #FFFFFF​
文字颜色,格式为 #RRGGBB 或 #RRGGBBAA。​
​
outline_color string Optional 示例值: #101010​
描边颜色,格式同 text_color。​
​
outline_width integer Optional 示例值: 40​
描边粗细档位,范围 [0,100];0 表示无描边。​
​
shadow_color string Optional 示例值: #000000​
阴影颜色,格式同 text_color。​
​
shadow_size integer Optional 示例值: 0​
阴影距离档位,范围 [0,100];0 表示无阴影。​
​
position_ratio float Optional 示例值: 0.87​
字幕行垂直中心占画面高度的比例,范围 [0.05,0.95],从顶部向下计。​
​
​
video_spec VideoSpecParams Optional​
目标交付规格;默认 1080×1920@60fps、非严格。​
width integer Optional 示例值: 1080​
画布宽度,范围 [64,7680],须与 height 同时设置。​
​
height integer Optional 示例值: 1920​
画布高度,范围 [64,7680],须与 width 同时设置。​
​
fps integer Optional 示例值: 60​
目标帧率,范围 [1,240]。​
​
strict boolean Optional 示例值: false​
false 时素材低于目标会降低整片交付规格,不上采样;true 时需要上采样或帧率不足则拒收。​
​
​
output_tos_path string Optional 示例值: tos://your-bucket/fast-remix/results/​
可写 TOS 输出目录;不传使用平台默认位置。​
​
​
​
​
返回数据​
metadata Metadata​
任务接收结果;不包含成片,需继续调用 Poll 查询。​
task_id string 示例值: task-example​
异步任务 ID,后续 Poll 必须使用该值。​
​
task_status string 示例值: PENDING​
任务状态。PENDING、RUNNING 时继续轮询;COMPLETED、FAILED、TIMEOUT、EXPIRED、CANCELLED 为终态。​
​
business_code string 示例值: 0​
业务处理码,成功为字符串 0;失败时结合 task_status 和 error_msg 排查。​
​
error_msg string​
错误说明,成功时为空。​
​
​
​
示例​
​
curl --location "https://operator.las.cn-beijing.volces.com/api/v1/submit" \​
--header "Content-Type: application/json" \​
--header "Authorization: Bearer $LAS_API_KEY" \​
--data '{"operator_id":"las_video_fast_remix","operator_version":"v1","data":{"video_urls":["tos://your-bucket/a.mp4","tos://your-bucket/b.mp4"],"target_duration_sec":30,"max_clips":3,"output_tos_path":"tos://your-bucket/results/"}}'​
​
手动分幕并合成旁白、字幕的完整请求示例:​
​
{​
"operator_id": "las_video_fast_remix",​
"operator_version": "v1",​
"data": {​
"acts": [​
{​
"video_urls": ["tos://example-bucket/opening-a.mp4", "tos://example-bucket/opening-b.mp4"],​
"requirement": "用产品效果对比吸引注意"​
},​
{​
"video_urls": ["tos://example-bucket/demo-a.mp4", "tos://example-bucket/demo-b.mp4"],​
"requirement": "展示产品的使用过程",​
"duration_sec": 7​
},​
{​
"video_urls": ["tos://example-bucket/cta.mp4"],​
"requirement": "展示活动优惠和下单入口"​
}​
],​
"script": "日常清洁太费力?这款产品让清洁更省心。现在下单,享受活动优惠。",​
"max_clips": 3,​
"tts": {​
"enable": true,​
"language": "zh",​
"speed": 1.0​
},​
"subtitle_style": {​
"text_color": "#FFFFFF",​
"outline_width": 40,​
"font_size": 60,​
"position_ratio": 0.8​
},​
"video_spec": {​
"width": 1080,​
"height": 1920,​
"fps": 30,​
"strict": false​
},​
"output_tos_path": "tos://example-bucket/remix-results/campaign-001/"​
}​
}​
​
自动分幕请求示例:​
​
{​
"operator_id": "las_video_fast_remix",​
"operator_version": "v1",​
"data": {​
"video_urls": ["tos://example-bucket/product-demo.mp4", "tos://example-bucket/product-details.mp4"],​
"enable_auto_chaptering": true,​
"target_duration_sec": 30,​
"max_clips": 2​
}​
}​
​
默认随机分幕可将 enable_auto_chaptering 显式设置为 false。Submit 成功返回示例:​
​
{​
"metadata": {​
"task_id": "task-example",​
"task_status": "PENDING",​
"business_code": "0",​
"error_msg": ""​
}​
}​
​
错误码​
​
​
HttpStatusCode​
错误码​
错误信息​
描述​
400​
Parameter.Invalid​
The parameter is invalid.​
请求参数类型、枚举、范围或组合不合法。​
401​
Authorization.Missing​
Missing Authorization.​
缺少鉴权信息。​
401​
ApiKey.Invalid​
The api key is invalid.​
API Key 无效。​
500​
Server.InternalError​
General Internal Error​
服务内部错误。​
​
表中为接口请求错误。异步任务已接收后的执行失败,应以 Poll 的 metadata.task_status、business_code 和 error_msg 为准。​
Poll​
请求参数​
​
​
名称​
类型​
是否必选​
示例值​
描述​
operator_id​
string​
是​
las_video_fast_remix​
固定为 las_video_fast_remix。​
operator_version​
string​
是​
v1​
固定为 v1。​
task_id​
string​
是​
task-xxx​
Submit 返回的任务 ID。​
​
返回数据​
metadata Metadata​
任务状态与错误信息。​
task_id string 示例值: task-example​
异步任务 ID。​
​
task_status string 示例值: COMPLETED​
PENDING、RUNNING 时继续轮询;COMPLETED 表示执行完成,需结合 business_code 判断成功;FAILED、TIMEOUT、EXPIRED、CANCELLED 为终态。​
​
business_code string 示例值: 0​
业务处理码,成功为字符串 0。​
​
error_msg string​
错误说明,成功时为空。​
​
submit_time string​
提交时间,ISO 8601 格式。​
​
end_time string​
任务结束时间,ISO 8601 格式;非终态可能为空。​
​
​
data FastRemixResponse​
仅在成功终态读取。​
clazz string 示例值: las_video_fast_remix​
固定为 las_video_fast_remix。​
​
act_mode string Optional 示例值: random​
random 为默认随机分幕,auto 为 AI 分幕;手动模式不返回。​
​
audio_source string 示例值: silent​
silent 无声、tts 合成旁白、voiceover 现成旁白;有文案的无声成片仍带字幕。​
​
acts list of object​
手动与 AI 模式的全局分幕;随机模式为空数组。​
​
materials list of object​
可用画面素材;随机模式具体分组见各变体 acts[].video_ids。​
​
narration Narration​
文案和单条规划时间轴。​
line_count integer​
文案分句数;无 script 时为 0。​
​
duration_sec float​
单条计划时长,单位秒。​
​
lines list of string​
按旁白顺序排列的分句;无文案时为空数组。​
​
​
requested_outputs integer​
实际采用的 max_clips。​
​
variant_count integer​
规划方案数,等于 plan.variants 长度。​
​
output_count integer​
实际成功交付的视频条数。​
​
duration_sec float​
全部成功成片的实际时长合计,单位秒。​
​
outputs list of FastRemixOutput​
成功成片。​
variant_id string​
组合方案标识。​
​
batch_index integer​
打乱方案后的序号,从 1 开始。​
​
order list of FastRemixShot​
成片镜头顺序。​
video_id string​
镜头来源素材标识。​
​
name string 示例值: product.mp4​
素材文件名。​
​
act integer 示例值: 1​
镜头所属幕编号。​
​
slot string 示例值: opening​
镜头叙事位置,可选 opening、content、ending。​
​
duration_sec float 示例值: 5​
本镜头在成片中占用的时长,单位秒。​
​
​
acts list of FastRemixActDuration​
本变体的分幕。​
act integer 示例值: 1​
幕编号,从 1 开始。​
​
duration_sec float 示例值: 5​
本幕分配的时长,单位秒。​
​
video_ids list of string Optional​
仅随机分幕返回的本幕候选素材标识。​
​
​
planned_duration_sec float​
单条计划时长。​
​
duration_sec float​
单条实际成片时长。​
​
subtitle_srt string​
本条 SRT;没有 script 时为空字符串。​
​
match_scheme object​
完整方案对象。​
​
artifacts Artifacts​
本条视频、SRT 与方案地址。​
​
​
plan FastRemixPlan​
全部规划变体,包含已渲染、未渲染与单条失败的方案。​
variants list of FastRemixVariant​
组合方案列表,长度与 variant_count 相同。每项返回 variant_id、batch_index、order、acts、planned_duration_sec、artifacts,字段结构与成功输出一致。​
rendered boolean 示例值: false​
是否已成功渲染;为 true 时可在 outputs 中找到相同的 variant_id。​
​
​
​
failed_variants list of VariantFailure Optional​
单条失败方案。​
variant_id string 示例值: v01​
失败的组合 ID。​
​
reason string​
失败原因摘要。​
​
​
skipped_materials list of SkippedMaterial Optional​
被跳过的素材。​
video_id string​
被跳过的源素材标识。​
​
reason string​
跳过原因。​
​
​
usage FastRemixUsage​
实际执行用量。​
version string​
用量结构版本。​
​
input_duration_ms integer​
自动分幕全部画面原始时长之和;同一素材仅计一次,不含现成旁白,手动与随机模式为 0。​
​
material_duration_ms integer​
素材理解处理时长,仅作计量参考。​
​
director_output_duration_ms integer​
成功成片总时长统计;成片计费依据为顶层 duration_sec,不重复计费。​
​
tts_chars integer​
实际合成旁白字符数。​
​
subtitle_chars integer​
实际渲染字幕字符数。​
​
effect_chars integer​
特效文字字符数;当前接口不提供花字包装。​
​
​
artifacts Artifacts​
任务级完整结果 JSON 地址;同结构也用于单条输出的产物地址。​
result_json_tos_path string​
完整结果 JSON 的 TOS 路径。​
​
result_json_url string​
结果 JSON 的临时下载链接。​
​
video_subtitled_tos_path string​
带字幕成片的 TOS 路径。​
​
video_subtitled_url string​
带字幕成片的临时访问链接。​
​
video_clean_tos_path string​
无本次新增字幕层成片的 TOS 路径。​
​
video_clean_url string​
无字幕版成片的临时下载链接。​
​
subtitle_srt_tos_path string​
独立 SRT 文件的 TOS 路径。​
​
subtitle_srt_url string​
SRT 文件的临时下载链接。​
​
match_scheme_tos_path string​
剪辑方案 JSON 的 TOS 路径。​
​
match_scheme_url string​
剪辑方案 JSON 的临时下载链接。​
​
video_clip_tos_paths list of string​
分段视频的 TOS 路径列表。​
​
video_clip_urls list of string​
分段视频的访问链接列表。​
​
​
​
​
​
请求示例:​
​
curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" \​
--header "Content-Type: application/json" \​
--header "Authorization: Bearer $LAS_API_KEY" \​
--data '{"operator_id":"las_video_fast_remix","operator_version":"v1","task_id":"task-example"}'​
​
成功返回示例(方案正文等省略):​
​
{​
"metadata": {​
"task_id": "task-example",​
"task_status": "COMPLETED",​
"business_code": "0",​
"error_msg": ""​
},​
"data": {​
"clazz": "las_video_fast_remix",​
"act_mode": "random",​
"audio_source": "silent",​
"acts": [],​
"narration": {"line_count": 0, "duration_sec": 15.0, "lines": []},​
"requested_outputs": 1,​
"variant_count": 1,​
"output_count": 1,​
"duration_sec": 15.0,​
"outputs": [​
{​
"variant_id": "v01",​
"batch_index": 1,​
"order": [​
{"video_id": "tos://your-bucket/product.mp4", "name": "product.mp4", "act": 1, "slot": "opening", "duration_sec": 15.0}​
],​
"acts": [{"act": 1, "duration_sec": 15.0, "video_ids": ["tos://your-bucket/product.mp4"]}],​
"planned_duration_sec": 15.0,​
"artifacts": {​
"video_clean_tos_path": "tos://your-bucket/fast-remix/results/batch_001/clean.mp4",​
"video_clean_url": "https://example.com/clean.mp4",​
"match_scheme_tos_path": "tos://your-bucket/fast-remix/results/batch_001/match_scheme.json"​
},​
"duration_sec": 15.0,​
"subtitle_srt": ""​
}​
],​
"plan": {​
"variants": [​
{​
"variant_id": "v01",​
"batch_index": 1,​
"order": [{"video_id": "tos://your-bucket/product.mp4", "name": "product.mp4", "act": 1, "slot": "opening", "duration_sec": 15.0}],​
"acts": [{"act": 1, "duration_sec": 15.0, "video_ids": ["tos://your-bucket/product.mp4"]}],​
"planned_duration_sec": 15.0,​
"rendered": true,​
"artifacts": {​
"video_clean_tos_path": "tos://your-bucket/fast-remix/results/batch_001/clean.mp4",​
"video_clean_url": "https://example.com/clean.mp4",​
"match_scheme_tos_path": "tos://your-bucket/fast-remix/results/batch_001/match_scheme.json"​
}​
}​
]​
},​
"artifacts": {"result_json_tos_path": "tos://your-bucket/fast-remix/results/result.json"},​
"usage": {​
"version": "v1",​
"input_duration_ms": 0,​
"material_duration_ms": 0,​
"director_output_duration_ms": 15000,​
"tts_chars": 0,​
"subtitle_chars": 0,​
"effect_chars": 0​
}​
}​
}​
​
错误码​
​
​
HttpStatusCode​
错误码​
错误信息​
描述​
400​
Parameter.Invalid​
The parameter is invalid.​
请求参数类型、枚举、范围或组合不合法。​
400​
Task.NotFound​
Task not found​
任务不存在、已过期或当前身份不可见。​
401​
Authorization.Missing​
Missing Authorization.​
缺少鉴权信息。​
401​
ApiKey.Invalid​
The api key is invalid.​
API Key 无效。​
500​
Server.InternalError​
General Internal Error​
服务内部错误。​
​
表中为接口请求错误。异步任务已接收后的执行失败,应以 Poll 的 metadata.task_status、business_code 和 error_msg 为准。​
​
最近更新时间:2026.10.29 10:23:23
这个页面对您有帮助吗?
有用
有用
无用
无用