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

AI 数据湖服务

复制全文
下载 pdf
视频生成
视频编辑增强版 2.0
复制全文
下载 pdf
视频编辑增强版 2.0

视频编辑增强版 2.0 算子(las_video_edit_enhance)在 Seedance 视频生成能力之上提供面向业务场景的编辑模板。请求通过 template.id 选择服务端维护的处理流程,在保持原视频动作、镜头、构图和时间线的基础上,完成直通生成、通用关键帧编辑、换脸、完整人物替换或全局风格迁移。

算子介绍

算子 ID : las_video_edit_enhance

核心能力

  • 模板化路由:业务只声明编辑目标,服务端模板负责选择 VLM、关键帧重绘、结构视频和 Seedance 提示词组装流程。
  • 通用关键帧编辑:VLM 理解视频和用户意图,选择关键帧并使用 Seedream 基于源帧画布编辑。
  • 完整人物替换:将原视频作为动作和时间线依据,以目标人物图和重绘关键帧锁定最终人物外观。
  • 风格迁移:默认使用纯深度结构视频保留空间、动作和镜头运动,减少原视频颜色、材质、字幕和摄影风格对结果的干扰。
  • 多主体映射:可在 user_prompt 中将多个源主体分别绑定到 image_urls 中不同的目标图。
  • 可控降级allow_fallback=true 时,预处理失败可降级为 basic 等价的直通生成;强语义编辑建议设为 false,避免返回未完成编辑的结果。

支持的预置模板

支持的模板类型和适用场景如下。

template.id

适用场景

参考图要求

不适合的场景

basic

已准备好完整提示词和参考素材,希望跳过 VLM、抽帧和重绘,直接请求 Seedance

可选

多人物、物体的编辑或者替换

general

通用关键帧编辑,例如局部移除、移动、属性修改,或暂未被专用模板覆盖的混合编辑

至少 1 张

多人物、物体的编辑或者替换

replace/person_replace

完整替换单个或多个人物,包括目标人物的脸、发型、体型、服装和配饰,并保留原视频动作与位置。多人物场景建议使用 seedance-2-5 模型。

至少 1 张目标人物图

同时替换人物和物品的场景

replace/subject_replace

替换视频中的物体、道具、局部背景、完整背景,或人物与环境的整体内容

至少 1 张目标参考图

只替换人物;只替换人物时使用 replace/person_replace

style_transfer/general

将完整视频转换为日漫、韩漫、国漫、3D 动画、真人写实等统一视觉风格,同时保持内容和时序

可选;有风格参考图时可传

只替换某个人或物体,而不改变全片风格

模板边界:

  • 只替换人物使用 replace/person_replace
  • 仅改变全局视觉媒介和风格使用 style_transfer/general;只编辑局部主体时不要使用风格迁移模板。
  • general 是通用兜底模板。专用模板能更明确地约束人物身份、替换范围和结构视频时,应优先使用专用模板。

效果展示


【影视剧集场景】
  • 输入视频
  • 示例场景-多人物替换
  • 参考图
    Image
    Image
    Image
  • 示例场景-风格迁移
  • 参考图
    Image
  • 示例场景-风格迁移
  • 参考图
    Image

【营销视频场景】
  • 输入视频
  • 替换人物
  • 替换商品
  • 替换背景

支持的地域

  • 北京:cn-beijing

算子性能

细分项
性能影响说明

最大 RPM

600

最大并发度

10

耗时

  • 总耗时与视频时长、关键帧数量、参考图数量、模板及下游模型排队情况有关。basic 不做预处理,通常耗时最短。

输入与输出要求

输入要求

细分
详细说明

支持的输入数据模态

  • 视频
  • 图片
  • 音频
  • 文本

输入路径要求

通过请求参数 video_urlimage_urls audio_url提供给算子输入数据,当前支持公网 URL、TOS 路径、LAS 素材ID这几种方式。

  • 公网 URL:公网可访问的视频 URL,格式为 http/https
  • TOS 路径:将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后,可提供 TOS 路径,格式为tos://bucket_name/demo
  • LAS 素材 ID:用于视频生成的真人人像及虚拟人像的 ID,遵循格式:asset://<asset-id>
    • 使用 LAS 素材 ID 的方式时,您需要先申请开通 LAS 素材资产管理功能(白名单功能,默认关闭),并在提交任务时设置seedance_use_asset_api = true
    • 提交各类任务时,如果输入的素材涉及真人音视频或图像时,您必须先将素材上传至 LAS 素材库,通过 LAS 素材 ID的方式将对应素材输入给模型,否则任务可能会被拦截。
    • 开通功能并上传素材后,您可以在 LAS 控制台 的 素材资产管理 > 虚拟人像资产 中查看各素材组列表,进入素材组详细页面后可获取具体素材的素材 ID(asset-id),通过上述格式拼接后座位算子的输入。

输出要求

细分
详细说明

输出数据模态

  • 视频

输出格式:视频

  • 比例:原视频比例(默认)、16:9、9:16、1:1、4:3、3:4、21:9。
  • 分辨率:支持设置为 480p、720p、1080p、4k(仅 seedance 2.0 支持 4k)。

输出路径:TOS

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

  • TOS 路径:与LAS服务同主账号、同地域下,有可写权限的 TOS Bucket 目录。

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    包含 视频预处理 与**视频编辑** 两个计费项,两个计费项均基于输入/输出视频的时长统计用量计费。

    • 视频预处理计费:
      • 与提交任务时,选择的视频编辑任务模板类型有关。提交算子任务时,通过template请求参数设置任务的处理模版,不同任务模板的视频预处理计费单价不一致。
    • 视频编辑计费:
      • 与提交任务时,选择使用的任务处理模型类型有关。提交算子任务时,通过model请求参数设置任务的处理模型,不同模型的视频编辑计费单价不一致。

    最终总费用为 视频预处理 与**视频编辑** 两个计费项之和。

    计费类型

    按量计费,单位:元/秒,按实际的计费用量每小时出账。计费精度:四舍五入。

    单价

    • 视频预处理单价:0.16 元/秒
    • 视频编辑单价详情:与您选用的模型类型、视频分辨率有关,详情见下表。

    注意

    • 每次任务的**视频编辑​**费用:除单价外,还与输入/输出视频的时长、输入/输出视频的分辨率有关。
    • 仅成功生成视频的任务会产生费用,因审核等运营导致视频生成失败的场景不收取费用。
  • 计费详情
    计费预估:总费用 ≈ 视频预处理费用 + 视频编辑费用 = 视频预处理单价* (输入视频时长 + 输出视频时长) + 视频编辑单价 * (输入视频时长+输出视频时长)

    注意

    以上公式仅作为费用估算,实际计费以账单推量为准。

    • 视频预处理单价:0.16 元/秒

    • 视频编辑单价详情:与您选用的模型类型、视频分辨率有关,详情如下。

      模型

      视频分辨率

      刊例价

      seedance_2.0_fast

      480p

      0.442 元/秒

      720p

      0.95 元/秒

      seedance_2.0_mini

      480p

      0.282 元/秒

      720p

      0.605 元/秒

      seedance_2.0

      480p

      0.562 元/秒

      720p

      1.208 元/秒

      1080p

      3.014 元/秒

      4k

      6.22 元/秒

      seedance_2.5

      480p

      0.806 元/秒

      720p

      1.814 元/秒

  • 计费示例

    • 示例场景:使用 replace/person_replace 任务模版、Seedance 2.0 模型进行视频人脸替换编辑,输入视频时长为 10 秒,分辨率为 1080p。
    • 费用详情:
      总费用 ≈ 视频预处理费用 + 视频编辑费用 = 0.16 元/秒 * (10秒+10秒)+ 3.014 元/秒 * (10秒+10秒) = 63.48 元

注意与前提

细分项

注意与前提

开通 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)运行状态,并获取算子处理结果。同时,本算子支持异步回调能力(Callback),您可在发起算子调用任务时设置回调参数callback.url,LAS 会向该 URL 发送 HTTP POST 通知,异步回调的使用指导可参见 异步回调 API
  • 任务提交后,任务的 task_id 有效期为 3 天,超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit

接口说明

调用视频编辑增强版 2.0 算子(las_video_edit_enhance)提交异步任务。算子通过 template.id 选择服务端维护的业务流程,在保持原视频动作、镜头、构图和时间线的基础上,完成直通生成、通用关键帧编辑、换脸、完整人物替换或全局风格迁移。

请求参数

名称
类型
是否必选
示例值
描述
operator_id
string
las_video_edit_enhance
算子 ID,固定值
operator_version
string
v1
算子版本,固定值
data
VideoEditEnhanceReqParams
-
视频编辑增强请求参数

返回数据

名称
类型
示例值
描述
metadata
metadata
-
异步任务元信息

示例

请求示例
basic:直通生成

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_edit_enhance",
  "operator_version": "v1",
  "data": {
    "video_url": "tos://bucket/videos/input.mp4",
    "template": {"id": "basic"},
    "user_prompt": "保持镜头和动作不变,提升画面清晰度与色彩层次",
    "image_urls": []
  }
}'

general:通用局部编辑

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_edit_enhance",
  "operator_version": "v1",
  "data": {
    "video_url": "tos://bucket/videos/input.mp4",
    "template": {"id": "general"},
    "user_prompt": "把桌面上的杯子改成参考图1中的产品,其他人物、物体和背景保持不变",
    "image_urls": ["https://example.com/product.png"]
  }
}'

replace/person_replace:完整人物替换

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_edit_enhance",
  "operator_version": "v1",
  "data": {
    "video_url": "tos://bucket/videos/input.mp4",
    "template": {
      "id": "replace/person_replace"
    },
    "user_prompt": "把视频中左侧女性完整替换为参考图1中的人物,把右侧男性完整替换为参考图2中的人物;使用目标人物的脸、发型、体型、服装和配饰,保留原视频动作、位置、互动、镜头和背景",
    "image_urls": [
      "https://example.com/woman.png",
      "https://example.com/man.png"
    ],
    "use_asset_api": true
  }
}'

style_transfer/general:全局风格迁移

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_edit_enhance",
  "operator_version": "v1",
  "data": {
    "video_url": "tos://bucket/videos/input.mp4",
    "template": {
      "id": "style_transfer/general",
      "paras": {
        "style_template": "2d_japanese"
      }
    },
    "user_prompt": "将完整视频转换为高完成度日系二维动画,保持人物身份、数量、动作、口型、镜头、构图和时间线,不要字幕和水印",
    "image_urls": [
      https://example.com/man.png
    ],
    "use_asset_api": true
  }
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260427143000-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": ""
  }
}

错误码

HttpStatusCode

错误码

错误信息

描述

400

Url.Invalid

The url is invalid.

视频、图片或音频引用不合法

400

Parameter.Invalid

The parameter is invalid.

模板不存在、模板参数不支持、必需参考图缺失或生成参数不合法

400

Model.InvalidName

The model name is invalid.

Seedance 模型名称不合法

400

Video.DownloadFailed

Video download failed.

视频下载失败

400

Tos.AccessFailed

TOS access failed.

TOS 访问失败

401

Authorization.Missing

Missing Authorization.

缺少鉴权信息

401

ApiKey.Invalid

The api key is invalid.

API Key 不合法

500

Internal.ServerError

Internal server error.

视频理解、生图、生视频或结果组装失败

Poll

接口说明

查询视频编辑增强任务的执行状态和结果。

请求参数

名称

类型

是否必选

示例值

描述

operator_id

string

las_video_edit_enhance

算子 ID

operator_version

string

v1

算子版本

task_id

string

task-xxx

任务 ID

返回数据

名称
类型
示例值
描述
metadata
metadata
请求元信息
data
VideoEditEnhanceResponse
返回的数据

示例

请求示例

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_edit_enhance",
    "operator_version": "v1",
    "task_id": "task-20260427143000-abc123"
}'

返回示例

{
  "metadata": {
    "task_status": "COMPLETED",
    "business_code": "0",
    "operator_id": "las_video_edit_enhance",
    "operator_version": "v1"
  },
  "data": {
    "id": "cgt-xxxxxxxx",
    "model": "doubao-seedance-2-0-260128",
    "status": "succeeded",
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "usage": { "completion_tokens": 221386, "total_tokens": 221386 },
    "content": {
      "video_url": "https://{bucket}.tos-cn-beijing.volces.com/xxxx/output.mp4?X-Tos-...",
      "last_frame_url": "https://{bucket}.tos-cn-beijing.volces.com/xxxx/last_frame.png?X-Tos-..."
    }
  }
}

错误码

HttpStatusCode

错误码

错误信息

描述

400

Parameter.Invalid

The parameter is invalid.

参数不合法,例如 task_id 缺失。

401

Authorization.Missing

Missing Authorization.

缺少鉴权。

401

ApiKey.Invalid

The api key is invalid.

API 不合法。

500

Internal.ServerError

Internal server error.

服务内部错误。

最近更新时间:2026.09.17 22:13:03
这个页面对您有帮助吗?
有用
有用
无用
无用