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

AI 数据湖服务

复制全文
下载 pdf
视频剪辑
视频智能混剪
复制全文
下载 pdf
视频智能混剪

视频智能混剪算子基于对输入素材的理解、语音识别、语义检索与大模型编排能力,将口播、空镜或长实拍素材按文案、结构化分镜或自然语言创作要求自动匹配、排序并剪辑合成为最终成片。

算子介绍

算子 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(仅提供画面)。
  • 结构化分镜:支持使用 speechvisual_descriptiondurationvideo_id 控制每个脚本单元。
  • 智能包装:支持字幕特效、音效和 BGM。
  • 方案与产物交付:算子处理完成后返回最终剪辑方案、SRT 字幕、无字幕成片和带字幕成片等产物。您也可通过 data.match_scheme 查看生成的剪辑方案和成片中,输入的脚本单元与视频素材片段的匹配关系。

效果展示

  • 输入示例
    • 输入示例1:口播视频
    • 输入示例2:空镜视频-内饰
    • 输入示例3:空镜视频-外饰
  • 任务代码示例-核心参数
    "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

耗时

整体耗时与素材数量、素材总时长、缓存命中情况、编辑档位以及是否渲染成片有关。

  • video_edit_mode=lite 跳过大模型评估修正,速度优先;pro 启用评估修正,质量优先且耗时更长。
  • 相同素材再次调用时,缓存命中的素材理解结果不会重复执行。

输入与输出要求

输入要求

细分

详细要求

支持的输入数据模态

  • 视频
  • 音频
  • 文本

输入模态:视频

  • 格式:mp4movm4vwebmmkvavi
  • 数量:单次输入最多支持 100 个视频。
  • 大小:单个剧集视频最短 1 秒,最长 10 分钟;单次输入的所有剧集视频总时长最长 2 小时、最大 10 GB。
  • 分辨率:所有输入视频必须保持分辨率一致,视频分辨率需在 360x640(360为短边,640 为长边)至1080x1920(1080为短边,1920 为长边)之间。
  • 其他要求:请确保输入视频中携带字幕。

输入模态:音频

输入素材仅用于最终成片的音频输入(role=voiceover )时,支持输入音频格式素材:

  • 格式:mp3wavm4aaacflacogg

输入模态:文本

对输入素材视频进行提炼剪辑时,可通过 script 参数输入每个分镜片段的提炼剪辑要求。

输入路径要求

通过请求参数 video_urls 提供给算子输入数据,当前支持公网 URL、TOS 路径这两种方式。

  • 公网 URL:公网可访问的视频 URL,格式为 http/https
    • 公网 URL 不支持需要登录态或额外 Header 鉴权的地址;临时 URL 需在任务执行期间有效。
  • TOS 路径:将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后,可提供 TOS 路径,格式为tos://bucket_name/demo/
    • TOS 对象需存在且具备读取权限。

输出要求

细分

详细要求

输出数据模态

  • 视频
  • 音频
  • 文本(剪辑方案JSON等)

输出模态:视频

  • 时长:输出成片时长最长不超过 10 分钟;
    • 当剪辑模式为mode=long_real_shot时,可通过 target_duration_sec 参数设置输出视频时长(10~600秒)。
    • 其他模式由模型决定输出成片时长,最长不超过 10 分钟。

输出路径:TOS

通过请求参数output_tos_pathtts_audio_tos_path 指定算子输出结果的存储路径,当前支持设置为 TOS 路径。

  • TOS 路径:与LAS服务同主账号、同地域下,有可写权限的 TOS Bucket 目录,格式:tos://bucket/output/

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    包含以下几个计费项:

    • 素材理解费用:输入视频素材的素材理解费用,基于输入视频素材总时间统计用量进行计费。
      • 通过 TOS 输入视频素材时,同一个素材,首次提交任务会产生素材理解费用。
      • 素材在 TOS 中没有变动时(路径、文件内容等没有变化),同一个素材不会重复产生xxx
    • 智能编导费用:生成最终视频成片时,调用模型编导最终视频内容的费用。基于输出成片总时长统计用量进行计费。未输出最终成片时不产生费用。
    • 口播配音(TTS)费用:按生成口播配音的字数统计用量进行计费。未生成口播配音时不产生费用。
    • 智能字幕费用:按生成智字幕的字数统计用量进行计费。未生成智能字幕时不产生费用。
    • 特效花字费用:按生成特效的字数统计用量进行计费。未生成特效花字时不产生费用。

    任务总费用为以上计费项费用之和。

    计费类型

    按量计费,按实际的计费用量每小时出账。计费精度:毫秒级、按比例、不满一分钟不补整。

    单价

    不同计费项的单价不同,详情如下。

  • 计费详情

    计费项
    单价

    素材理解

    0.4 元/分钟

    智能编导

    • lite:8 元/分钟
    • pro:13 元/分钟

    口播配音

    0.3 元/千字

    智能字幕

    1.4 元/千字

    特效花字

    0.2 元/千字

注意与前提

细分项

注意与前提

开通 LAS

  • 如果您是一个全新的火山引擎用户,此前未开通过 LAS 产品,您可先开通 LAS,不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作
  • 开通完成后可查看算子介绍文档,了解算子能力、上手引导等,详情可参见:LAS 智能数据处理算子

费用

调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费

鉴权(API Key)

调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置

BaseURL

调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。
详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。

Rest API 调用

API 调用说明

  • 本算子的 API 为异步任务接口,您需要通过 Submit 接口提交任务获得任务的 task_id,再通过 Poll 接口获取对应任务(task_id)运行状态,并获取算子处理结果。
  • 注意,任务提交后,任务的 task_id 有效期为 3 天,超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit

接口说明

提交视频智能混剪异步任务。算子根据素材与脚本生成剪辑方案,并可进一步完成字幕、智能包装、视频渲染和 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_codemetadata.error_msg 返回。

Poll

接口说明

查询视频智能混剪异步任务的执行状态和结果。仅当 task_status=COMPLETEDbusiness_code=0 时返回完整 dataPENDINGRUNNINGFAILEDTIMEOUT 状态下通常不返回 data

请求参数

名称

类型

是否必选

示例值

描述

operator_id

string

las_video_remix

算子 ID,固定为 las_video_remix

operator_version

string

v1

算子版本,固定为 v1

task_id

string

task-20260813143000-abc123

Submit 返回的 metadata.task_id

返回数据

名称
类型
示例值
描述
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
    }
  }
}

轮询与错误处理

  • PENDINGRUNNING 为非终态,应继续轮询。
  • COMPLETEDFAILEDTIMEOUT 为终态。仅 COMPLETEDbusiness_code=0 表示成功。
  • FAILEDTIMEOUT 时,使用 metadata.business_codemetadata.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.InvalidMaterial.EmptyShot.EmptyTos.AccessFailed 或服务内部错误,具体原因见 error_msg

最近更新时间:2026.08.30 16:49:08
这个页面对您有帮助吗?
有用
有用
无用
无用