视频智能混剪算子基于对输入素材的理解、语音识别、语义检索与大模型编排能力,将口播、空镜或长实拍素材按文案、结构化分镜或自然语言创作要求自动匹配、排序并剪辑合成为最终成片。
算子 ID:las_video_remix
mode)生成剪辑方案。支持的剪辑场景模式包括:
mode=speech_match, 输入需要剪辑提取的脚本文案,算子会在视频素材 ASR 中定位对应片段,剪辑输出命中片段的原始音画。此类场景下,输入的视频素材的视频画面和音频均可直接用于剪辑输出。mode=visual_match ,通过自然语音描述需要提取剪辑出的视频素材,例如视频画面的描述或视频内容文案的描述,此场景下,通常输入的视频素材的画面可用于剪辑输出,但音频通常不可用,您可选择输入 TTS 旁白来替代素材原声。mode=marketing_headtalk 对拍摄好的口播素材进行智能粗剪,并按语义选择性插入空镜;当前为您预置了汽车真人口播常见下的剪辑模板,您可直接选用。mode=long_real_shot 面向谈价、交车、维修、探店等长实拍素材,按原声原画整理完整故事线进行智能剪辑,并支持通过 target_duration_sec 参数设置输出视频时长。role)参数,将输入的视频素材标记为 speech(口播/主体素材)、voiceover(仅使用音频)或 broll(仅提供画面)。speech、visual_description、duration 和 video_id 控制每个脚本单元。data.match_scheme 查看生成的剪辑方案和成片中,输入的脚本单元与视频素材片段的匹配关系。"data": { "video_urls": [ { "url": "tos://las-doctest/las-ai/input/video/marketing_video/car/v2/headtalk_01.mp4", "role": "speech" }, { "url": "tos://las-doctest/las-ai/input/video/marketing_video/car/v2/car_exterior_broll.mp4", "role": "broll" }, { "url": "tos://las-doctest/las-ai/input/video/marketing_video/car/v2/car_interior_broll.mp4", "role": "broll" } ], "mode": "marketing_headtalk", "template": "automotive_headtalk", "script": "剪成一条节奏紧凑、画面真实的竖屏新能源轿车营销短视频。保留销售顾问完整、无重复的核心口播。成片必须实际使用两条空镜素材:介绍续航和日常通勤时插入车辆展厅外观空镜;介绍智能座舱、乘坐空间、储物和补能效率时插入内饰、储物、后排及充电空镜;每类空镜至少插入两处,空镜期间继续使用销售顾问原声。结尾切回销售顾问并保留邀请到店体验的口播。输入素材没有字幕,只使用算子生成的普通字幕和动态花字,避免字幕重叠;开启音效和背景音乐。包装风格简洁专业,不遮挡人物面部和车辆主体,不强调任何品牌、车型名称或版本信息。", "video_edit_mode": "lite", "smart_packaging": { "enabled": true, "enable_subtitle_effect": true, "enable_sound_effect": true, "enable_bgm": true }, "output_tos_path": "${OUTPUT_TOS_PATH}" }
cn-beijing细分项 | 性能影响说明 |
|---|---|
最大 RPM | 600 |
最大并发数 | 10 |
耗时 | 整体耗时与素材数量、素材总时长、缓存命中情况、编辑档位以及是否渲染成片有关。
|
细分 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入模态:视频 |
|
输入模态:音频 | 输入素材仅用于最终成片的音频输入(
|
输入模态:文本 | 对输入素材视频进行提炼剪辑时,可通过 |
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出模态:视频 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 包含以下几个计费项:
任务总费用为以上计费项费用之和。 |
计费类型 | 按量计费,按实际的计费用量每小时出账。计费精度:毫秒级、按比例、不满一分钟不补整。 |
单价 | 不同计费项的单价不同,详情如下。 |
计费详情
计费项 | 单价 |
|---|---|
素材理解 | 0.4 元/分钟 |
智能编导 |
|
口播配音 | 0.3 元/千字 |
智能字幕 | 1.4 元/千字 |
特效花字 | 0.2 元/千字 |
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
Submit 接口提交任务获得任务的 task_id,再通过 Poll 接口获取对应任务(task_id)运行状态,并获取算子处理结果。task_id 有效期为 3 天,超过 3 天后即无法通过此 task_id 来获取算子处理结果。提交视频智能混剪异步任务。算子根据素材与脚本生成剪辑方案,并可进一步完成字幕、智能包装、视频渲染和 TOS 交付。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_remix | 算子 ID,固定为 las_video_remix。 |
operator_version | string | 是 | v1 | 算子版本,固定为 v1。 |
data | VideoRemixReqParams | 是 | 视频混剪业务参数。 |
名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | Metadata | 异步任务元信息。 |
以下示例使用 marketing_headtalk 对口播素材和空镜素材进行营销混剪。请将 TOS 路径替换为当前账号同地域的可读写路径。
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_remix", "operator_version": "v1", "data": { "video_urls": [ { "url": "tos://your-bucket/remix/materials/headtalk_01.mp4", "role": "speech" }, { "url": "tos://your-bucket/remix/materials/product_broll.mp4", "role": "broll" } ], "mode": "marketing_headtalk", "script": "剪成一条节奏紧凑的产品介绍,开场突出核心卖点,结尾引导了解详情。", "video_edit_mode": "lite", "smart_packaging": { "enabled": true }, "output_tos_path": "tos://your-bucket/remix/results/" } }'
{ "speech_match": { "mode": "speech_match", "script": "第一句口播。第二句口播。" }, "visual_match": { "mode": "visual_match", "script": [ { "speech": "今天介绍这款新品。", "visual_description": "产品外观特写" }, { "visual_description": "户外使用场景", "duration": 3 } ], "tts": { "enable": true, "language": "zh" } }, "long_real_shot": { "mode": "long_real_shot", "script": "整理一条完整的谈价流程,以最终成交为结尾。", "target_duration_sec": 180 } }
{ "metadata": { "task_id": "task-20260813143000-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid. | 参数类型、模式、枚举、范围、素材角色或参数组合不合法。 |
400 | Material.Empty | no material video found | TOS 前缀下没有视频,或未找到可用素材。 |
400 | Shot.Empty | initialization produced no shots | 素材初始化未产出可匹配分镜。 |
400 | Tos.AccessFailed | Failed to access TOS path with provided credentials | TOS 输入/输出地址无效、对象不存在或当前身份无读写权限。 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权信息。 |
401 | ApiKey.Invalid | The api key is invalid. | API Key 无效。 |
429 | Server.Busy | Server is Busy, please try again later. | 服务繁忙或触发限流。 |
500 | Server.InternalError | General Internal Error | 服务内部错误,例如子算子、匹配或渲染失败。 |
上表为请求校验或任务创建阶段可能返回的错误。素材理解、匹配、渲染和上传等异步错误通过 Poll 的 metadata.business_code 与 metadata.error_msg 返回。
查询视频智能混剪异步任务的执行状态和结果。仅当 task_status=COMPLETED 且 business_code=0 时返回完整 data;PENDING、RUNNING、FAILED、TIMEOUT 状态下通常不返回 data。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_remix | 算子 ID,固定为 |
operator_version | string | 是 | v1 | 算子版本,固定为 |
task_id | string | 是 | task-20260813143000-abc123 | Submit 返回的 |
名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | Metadata | 任务元信息。 | |
data | VideoRemixResponse | 成功终态的混剪结果;其他状态下通常不返回或为空。 |
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_remix", "operator_version": "v1", "task_id": "task-20260813143000-abc123" }'
以下为 marketing_headtalk 的成功终态示例。临时预签名链接的有效期以服务端实际返回为准;长期保存请使用 TOS 地址。
{ "metadata": { "task_id": "task-20260813143000-abc123", "task_status": "COMPLETED", "submit_time": "2026-08-13T14:30:00+08:00", "end_time": "2026-08-13T14:33:10+08:00", "business_code": "0", "error_msg": "" }, "data": { "clazz": "las_video_remix", "mode": "marketing_headtalk", "confidence": 0.92, "duration_sec": 58.6, "shot_count": 126, "unit_count": 12, "match_scheme": { "audio_mode": "asr_match", "units": [ { "index": 0, "text": "开场突出产品的核心卖点。", "video_name": "headtalk_01.mp4", "start_time": "00:00:01.200", "end_time": "00:00:04.600", "duration": 3.4, "media_binding": "lock_av" } ], "notes": [] }, "subtitle_srt": "1\n00:00:00,000 --> 00:00:03,400\n开场突出产品的核心卖点。", "subtitle_effects_enabled": true, "artifacts": { "video_subtitled_tos_path": "tos://your-bucket/remix/results/subtitled.mp4", "video_subtitled_url": "https://example.com/subtitled.mp4", "video_clean_tos_path": "tos://your-bucket/remix/results/clean.mp4", "video_clean_url": "https://example.com/clean.mp4", "subtitle_srt_tos_path": "tos://your-bucket/remix/results/subtitle.srt", "subtitle_srt_url": "https://example.com/subtitle.srt", "match_scheme_tos_path": "tos://your-bucket/remix/results/match_scheme.json", "match_scheme_url": "https://example.com/match_scheme.json", "result_json_tos_path": "tos://your-bucket/remix/results/result.json", "result_json_url": "https://example.com/result.json" }, "usage": { "version": "v1", "material_duration_ms": 180000, "director_tier": "lite", "director_output_duration_ms": 58600, "tts_chars": 0, "subtitle_chars": 320, "effect_chars": 86 } } }
轮询与错误处理
PENDING、RUNNING 为非终态,应继续轮询。COMPLETED、FAILED、TIMEOUT 为终态。仅 COMPLETED 且 business_code=0 表示成功。FAILED 或 TIMEOUT 时,使用 metadata.business_code 与 metadata.error_msg 排查,不要读取空的 data 作为业务结果。HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid. | Poll 请求参数不合法。 |
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 | 服务内部错误。 |
任务执行失败时,metadata.business_code 还可能返回 Parameter.Invalid、Material.Empty、Shot.Empty、Tos.AccessFailed 或服务内部错误,具体原因见 error_msg。