视频编辑增强版--AI 数据湖服务-火山引擎

文档中心

AI 数据湖服务

视频处理

视频编辑增强版

视频编辑增强版在线服务，结合输入视频与参考图片完成定向视频替换，适用于广告素材重制、商品替换、背景重绘和视频创意编辑等场景。

算子介绍

算子 ID : las_video_seedance_replace

核心能力

当前版本支持场景替换（scene_replace）和物体替换（object_replace）两类视频智能编辑任务。
- 场景替换（scene_replace）：保持原视频中的人物、商品、动作和镜头结构，替换背景或环境风格。
- 物体替换（object_replace）：基于参考图片将视频中的目标物体替换为指定样式或商品。
视频编辑结果质量与稳定性保障。
- 支持通过 user_prompt 补充自然语言编辑约束，例如保留动作、移除水印、避免字幕或控制风格细节。
- 支持有限次数的自动评估与重试，帮助在复杂素材上获得更稳定的替换结果。
- 支持返回最终视频结果和诊断文件（result.json ），便于调用方留存生成结果与过程信息。

效果展示

输入视频

场景1输入图片：背景替换-参考图
场景2输入图片：物体替换-参考图

背景替换
物体替换

支持的地域

北京：cn-beijing
上海：cn-shanghai
广州：cn-guangzhou

算子性能

细分项	性能影响说明
耗时	总耗时与视频时长、参考图数量、替换复杂度、是否开启重试以及网络环境相关。开启重试（ `enable_retry` ）会提升生成成功率和效果稳定性，但会明显增加整体耗时与成本。
处理结果质量	视频内容替换处理结果质量与是否传入参考图、参考图内容有关。建议传入的参考图片，是三视图+细节放大图，尤其是场景替换，参考图视角和远近景和原视频保持一致可以明显提高替换概率。

细分项

性能影响说明

耗时

总耗时与视频时长、参考图数量、替换复杂度、是否开启重试以及网络环境相关。

开启重试（ enable_retry ）会提升生成成功率和效果稳定性，但会明显增加整体耗时与成本。

处理结果质量

视频内容替换处理结果质量与是否传入参考图、参考图内容有关。

建议传入的参考图片，是三视图+细节放大图，尤其是场景替换，参考图视角和远近景和原视频保持一致可以明显提高替换概率。

输入与输出要求

输入要求

细分	详细说明
支持的输入数据模态	视频图片音频
输入格式：视频	格式：mp4、mov 大小：`2-15` 秒，单个视频的输入大小不超过 50 MB。总请求体（视频+图片+音频）所有输入不可超过 64 MB。分辨率：480p、720p、1080p 尺寸：宽高比（宽/高）：［0.4,2.5］宽高长度（px）：[300,6000] 总像素数：［640x640=409600,2206×946=2086876］，即宽和高的乘积符合［409600，2086876］的区间要求。其他：建议使用主体明确、镜头相对稳定的视频素材
输入格式：图片	格式：jpeg、png、webp、bmp、tiff、gif、heic 和 heif。数量：支持输入`1-9` 张参考图片。大小：单张图片小于 30 MB。总请求体（视频+图片+音频）所有输入不可超过 64 MB。分辨率：宽高长度（px）：（300,6000）、宽高比（宽/高）：（0.4,2.5）其他：建议传入的参考图片，是三视图+细节放大图
输入格式：音频	格式：wav、mp3 大小：音频时长［2,15］s，单个音频不超过 15 MB。总请求体（视频+图片+音频）所有输入不可超过 64 MB。
输入路径要求	通过请求参数 `video_url`、`image_urls` 、`audio_url`提供给算子输入数据，当前支持公网 URL、TOS 路径、Base64 编码（仅图片和音频支持）这几种方式。公网 URL：公网可访问的视频 URL，格式为 `http/https`。 TOS 路径：将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后，可提供 TOS 路径，格式为`tos://bucket_name/demo`。 Base64 编码（仅图片和音频支持）：将本地文件转换为 Base64 编码字符串，然后提交给大模型。大文件请勿使用Base64编码。图片输入遵循格式：`data:image/＜图片格式>；base64，<Base64编码>`，注意 `<图片格式>`需小写，如`data:image/png;base64，｛base64_image｝`。音频输入遵循格式：`data:audio/<音频格式>；base64， <Base64编码>`，注意 `＜音频格式>`需小写，如 `data:audio/wav;base64，｛base64_audio｝`。

输出要求

细分	详细说明
输出数据模态	视频文本（JSON 文件）
输出格式：视频	大小：输出视频时长在 `4-15` 秒范围内。比例：原视频比例（默认）、16:9、9:16、1:1、4:3、3:4、21:9、9:21。分辨率：按输入视频自动处理（默认）、480p、720p、1080p。
输出路径：TOS	通过请求参数`output_tos_path` 指定算子输出结果的存储路径，当前支持设置为 TOS 路径。 TOS 路径：与LAS服务同主账号、同地域下，有可写权限的 TOS Bucket 目录。

细分

详细说明

输出数据模态

视频
文本（JSON 文件）

输出格式：视频

大小：输出视频时长在 4-15 秒范围内。
比例：原视频比例（默认）、16:9、9:16、1:1、4:3、3:4、21:9、9:21。
分辨率：按输入视频自动处理（默认）、480p、720p、1080p。

输出路径：TOS

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

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

计费说明

计费标准

细分项	计费标准说明
计费项	输入/输出视频的时长。
计费类型	按量计费，单位：元/秒，按实际的计费用量每小时出账。
单价	与您选择使用的算子服务版本（基础版、增强版）有关。

注意

支付的总费用：除单价外，还与输入/输出视频的时长、输入/输出视频的分辨率有关。
仅成功生成视频的任务会产生费用，因审核等运营倒是视频生成失败的场景不收取费用。

计费详情
计费预估：总费用 ≈ 单价 * 计费用量 = 单价 * (视频时长 * 时长折算系数)

注意

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

版本细分	单价	细分场景	计费项：视频时长	时长折算系数：与视频分辨率有关
基础版	1.6 元/秒	无输入视频	输出视频时长	480P：0.465 720P：1
基础版	1.6 元/秒	有输入视频	（输入视频时长+输出视频时长）/2	480P：0.554 720P：1.220
增强版	2 元/秒	无输入视频	输出视频时长	480P：0.465 720P：1 1080P：2.504
增强版	2 元/秒	有输入视频	（输入视频时长+输出视频时长）/2	480P：0.580 720P：1.220 1080P：3.040

计费示例
- 示例场景：使用视频生成-增强版进行视频生成，输入包含参考视频（时长5秒），输出视频时长7秒，分辨率为1080p。
- 费用详情：
  总费用 ≈ 单价 * 计费用量 = 2 元/秒 * （5秒 + 7秒）/2 * 3.040 = 36.48 元

注意与前提

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：LAS 智能数据处理算子。
费用	调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。
鉴权（API Key）	调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。
BaseURL	调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

Rest API 调用

Submit

接口说明

调用视频编辑增强版算子提交异步任务，支持基于输入视频和参考图片进行场景替换或物体替换，并将结果上传到指定 TOS 目录。

请求参数

参数	类型	是否必填	示例值	描述
operator_id	string	是	las_video_seedance_replace	算子 ID
operator_version	string	是	v1	算子版本
data	VideoSeedanceReplaceReqParams	是		视频替换请求参数

返回数据

参数	类型	示例值	描述
metadata	metadata		请求元信息

请求示例

# 请将 OUTPUT_TOS_PATH 设置为本账号上可写入的 tos 路径
export OUTPUT_TOS_PATH="tos://path/to/seedance_replace_results"

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_seedance_replace",
    "operator_version": "v1",
    "data": {
        "video_url": "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_seedance_replace/v1/sample_input.mp4",
        "image_urls": [
            "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_seedance_replace/v1/sample_reference.jpg"
        ],
        "output_tos_path": "$OUTPUT_TOS_PATH",
        "user_prompt": "请帮我把@视频1的背景替换成@图片1的风格，保持人物动作和商品一致性，除背景外不做任何更改，不要字幕。",
        "task_type": "scene_replace",
        "enable_retry": true,
        "max_retry_times": 2
    }
}'

返回示例

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

错误码

HttpStatusCode	错误码	错误信息	描述
400	Url.Invalid	The url is invalid.	输入视频、参考图或音频链接不合法。
400	Video.Invalid	The video file is invalid.	视频文件不合法或无法解析。
400	Video.DownloadFailed	Video download failed.	视频下载失败。
400	Video.FormatUnsupported	Video format not supported.	视频格式不支持。
400	Video.DurationTooShort	Video duration is too short.	视频时长低于最小限制。
400	Video.DurationExceeded	Video duration exceeds maximum limit.	视频时长超出最大限制。
400	Video.FileTooLarge	Video file size exceeds maximum limit.	视频文件过大。
400	Parameter.Invalid	The parameter is invalid.	参数不合法。
400	Video.Timeout	Video processing timeout.	视频处理超时。
400	Video.UploadFailed	Video upload failed.	结果视频上传失败。
400	Tos.AccessFailed	TOS access failed.	TOS 访问失败。
401	Authorization.Missing	Missing Authorization.	缺少鉴权。
401	ApiKey.InValid	The api key is invalid.	API 不合法。
500	Internal.ServerError	Internal server error.	服务内部错误，例如生成、评估或结果组装失败。

Poll

接口说明

查询视频替换任务的执行状态和结果。

请求参数

名称	类型	是否必选	示例值	描述
operator_id	string	是	las_video_seedance_replace	算子 ID
operator_version	string	是	v1	算子版本
task_id	string	是	task-xxx	任务 ID

返回数据

参数	类型	示例值	描述
metadata	metadata		请求元信息
data	VideoSeedanceReplaceResponse		返回的数据

请求示例

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

返回示例

{
  "metadata": {
    "task_id": "task-20260427143000-abc123",
    "task_status": "COMPLETED",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "output_video_tos_url": "tos://path/to/seedance_replace_results/run_id/generated/attempt_01.mp4",
    "output_video_url": "https://path/to/seedance_replace_results/run_id/generated/attempt_01.mp4",
    "selected_attempt_no": 1,
    "attempt_count": 1,
    "output_result_json_tos_url": "tos://path/to/seedance_replace_results/run_id/result.json",
    "output_result_json_url": "https://path/to/seedance_replace_results/run_id/result.json"
  }
}

错误码

HttpStatusCode	错误码	错误信息	描述
400	Url.Invalid	The url is invalid.	输入视频、参考图或音频链接不合法。
400	Video.Invalid	The video file is invalid.	视频文件不合法或无法解析。
400	Video.DownloadFailed	Video download failed.	视频下载失败。
400	Video.FormatUnsupported	Video format not supported.	视频格式不支持。
400	Video.DurationTooShort	Video duration is too short.	视频时长低于最小限制。
400	Video.DurationExceeded	Video duration exceeds maximum limit.	视频时长超出最大限制。
400	Video.FileTooLarge	Video file size exceeds maximum limit.	视频文件过大。
400	Parameter.Invalid	The parameter is invalid.	参数不合法。
400	Video.Timeout	Video processing timeout.	视频处理超时。
400	Video.UploadFailed	Video upload failed.	结果视频上传失败。
400	Tos.AccessFailed	TOS access failed.	TOS 访问失败。
401	Authorization.Missing	Missing Authorization.	缺少鉴权。
401	ApiKey.InValid	The api key is invalid.	API 不合法。
500	Internal.ServerError	Internal server error.	服务内部错误。

最近更新时间：2026.06.22 21:12:20

这个页面对您有帮助吗？

有用

无用

AI 数据湖服务

核心能力 #

效果展示 #

支持的地域 #

算子性能 #

输入要求 #

输出要求 #

Submit #

接口说明 #

请求参数 #

返回数据 #

请求示例 #

返回示例 #

错误码 #

Poll #

接口说明 #

请求参数 #

返回数据 #

请求示例 #

返回示例 #

错误码 #

核心能力

效果展示

支持的地域

算子性能

输入要求

输出要求

Submit

接口说明

请求参数

返回数据

请求示例

返回示例

错误码

Poll

接口说明

请求参数

返回数据

请求示例

返回示例

错误码