AI 数据湖服务
AI 数据湖服务
算子广场
请输入
- 文档首页
AI 数据湖服务视频视频生成视频编辑增强版 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，避免返回未完成编辑的结果。
支持的预置模板
支持的模板类型和适用场景如下。
模板边界：
- 只替换人物使用 replace/person_replace。
- 仅改变全局视觉媒介和风格使用 style_transfer/general；只编辑局部主体时不要使用风格迁移模板。
- general 是通用兜底模板。专用模板能更明确地约束人物身份、替换范围和结构视频时，应优先使用专用模板。
效果展示
【影视剧集场景】
- 输入视频
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 示例场景-多人物替换
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 参考图
-
-
-
- 示例场景-风格迁移
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 参考图
-
- 示例场景-风格迁移
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 参考图
-
【营销视频场景】
- 输入视频
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 替换人物
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 替换商品
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 替换背景
-
Replay Play00:00 / 00:08 Live 00:00FullscreenCssfullscreenClick and hold to drag
支持的地域
- 北京：cn-beijing
算子性能
细分项 | 性能影响说明 |
最大 RPM | 600 |
最大并发度 | 10 |
耗时 | * 总耗时与视频时长、关键帧数量、参考图数量、模板及下游模型排队情况有关。basic 不做预处理，通常耗时最短。 |
输入与输出要求
输入要求
细分 | 详细说明 |
支持的输入数据模态 |
|
输入路径要求 | 通过请求参数 video_url、image_urls、audio_url提供给算子输入数据，当前支持公网 URL、TOS 路径、LAS 素材ID这几种方式。
|
输出要求
细分 | 详细说明 |
输出数据模态 | * 视频 |
输出格式：视频 |
|
输出路径：TOS | 通过请求参数output_tos_path 指定算子输出结果的存储路径，当前支持设置为 TOS 路径。
|
计费说明
- 计费标准
-
- 细分项计费标准说明计费项包含 视频预处理 与**视频编辑** 两个计费项，两个计费项均基于输入/输出视频的时长统计用量计费。
- 视频预处理计费：
- 与提交任务时，选择的视频编辑任务模板类型有关。提交算子任务时，通过template请求参数设置任务的处理模版，不同任务模板的视频预处理计费单价不一致。
- 视频编辑计费：
- 与提交任务时，选择使用的任务处理模型类型有关。提交算子任务时，通过model请求参数设置任务的处理模型，不同模型的视频编辑计费单价不一致。
最终总费用为 视频预处理 与**视频编辑** 两个计费项之和。计费类型按量计费，单位：元/秒，按实际的计费用量每小时出账。计费精度：四舍五入。单价- 视频预处理单价：0.16 元/秒
- 视频编辑单价详情：与您选用的模型类型、视频分辨率有关，详情见下表。
注意
- 每次任务的**视频编辑**费用：除单价外，还与输入/输出视频的时长、输入/输出视频的分辨率有关。
- 仅成功生成视频的任务会产生费用，因审核等运营导致视频生成失败的场景不收取费用。
- 计费详情
- 计费预估：总费用 ≈ 视频预处理费用 + 视频编辑费用 = 视频预处理单价* （输入视频时长 + 输出视频时长） + 视频编辑单价 * （输入视频时长+输出视频时长）
注意
以上公式仅作为费用估算，实际计费以账单推量为准。
- 视频预处理单价：0.16 元/秒
- 视频编辑单价详情：与您选用的模型类型、视频分辨率有关，详情如下。
-
- 模型视频分辨率刊例价seedance_2.0_fast480p0.442 元/秒720p0.95 元/秒seedance_2.0_mini480p0.282 元/秒720p0.605 元/秒seedance_2.0480p0.562 元/秒720p1.208 元/秒1080p3.014 元/秒4k6.22 元/秒seedance_2.5480p0.806 元/秒720p1.814 元/秒1080p4.472 元/秒
- 计费示例
- 示例场景：使用 replace/person_replace 任务模版、Seedance 2.0 模型进行视频人脸替换编辑，输入视频时长为 10 秒，分辨率为 1080p。
- 费用详情：
- 总费用 ≈ 视频预处理费用 + 视频编辑费用 = 0.16 元/秒 * （10秒+10秒）+ 3.014 元/秒 * （10秒+10秒） = 63.48 元
注意与前提
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 必选 示例值: -
视频编辑增强请求参数
video_url string 必选 示例值: -
源视频。支持 http/https、tos://bucket/key、asset:// 或裸 asset id
template object 必选 示例值: -
业务模板，格式为 {"id":"...","paras":{}}
id string 必选
模板 ID，必须是“模板选择”表中的值
paras object Optional
模板参数，默认 {}；不允许传入模板未声明的参数
basic object Optional 示例值: {}
无模板参数，必须传 {} 或省略 paras
general object Optional 示例值: {}
无模板参数，必须传 {} 或省略 paras
style_transfer/general object Optional 示例值: {"style_template":"2d_japanese"}
可选参数 style_template，类型为 string，默认自动识别；
- 显式指定服务端风格模板时传入，支持：2d_american、2d_japanese、2d_korean、2d_chinese、2d_cyberpunk、3d_default、realistic_default、realistic_cyberpunk、realistic_wuxia、realistic_suspense、realistic_classical、free_style。
- 不传时根据 user_prompt 识别。
user_prompt string 必选 示例值: -
用户编辑目标。应写清源主体、目标参考图对应关系、需要修改和必须保留的内容
image_urls array Optional 示例值: []
参考图列表（字符串数组）。支持 http/https、tos://、asset://；顺序对应提示词中的参考图序号
audio_urls array Optional 示例值: []
音频参考列表（字符串数组），支持与图片相同的远程引用格式
allow_fallback boolean Optional 示例值: false
预处理失败时是否降级为 basic 等价的直通请求。人物替换、换脸等强语义任务建议设置为 false
model string Optional 示例值: 服务端配置
Seedance 模型，如 doubao-seedance-2-0-260128 或 doubao-seedance-2-5-260628
duration integer Optional 示例值: null
传入时必须 >= -1；Seedance 2.5 只能设置为 -1
resolution string Optional 示例值: null
Seedance 2.0 mini 和 fast 支持 480p、720p；Seedance 2.0 支持 480p、720p、1080p、4k；Seedance 2.5 支持 480p、720p、1080p
ratio string Optional 示例值: adaptive
16:9、4:3、1:1、3:4、9:16、21:9、adaptive
generate_audio boolean Optional 示例值: true
是否由 Seedance 生成同步音频
watermark boolean Optional 示例值: false
是否显示 AI 生成水印
return_last_frame boolean Optional 示例值: false
是否返回生成视频尾帧
priority integer Optional 示例值: 0
Seedance 任务优先级
execution_expires_after integer Optional 示例值: 172800
任务执行有效期，范围 [3600, 259200] 秒
callback_url string Optional 示例值: null
状态变化回调地址，必须是公网可访问的 HTTPS URL
safety_identifier string Optional 示例值: null
终端用户唯一标识，用于安全审计
moderation_options object Optional 示例值: null
审核 IP 配置，例如 {"ip_mode":"custom","ips":["ip-1"]}；ips 可为空数组
output_format string Optional 示例值: mp4
仅 Seedance 2.5 生效
omni_reference_task_type string Optional 示例值: auto
仅 Seedance 2.5 生效
use_asset_api boolean Optional 示例值: false
是否把素材转换为 Seedance Asset 引用；真人视频通常需要开启
asset_group_id string Optional 示例值: null
Asset 分组 ID，不传时由服务端查找或创建
返回数据
metadata metadata 示例值: -
异步任务元信息
task_id string 示例值: task-xxx
用于 Poll 查询的任务 ID
task_status string 示例值: PENDING
PENDING、RUNNING、COMPLETED、FAILED、TIMEOUT
business_code string 示例值: 0
业务码
error_msg string 示例值: -
失败原因
示例
请求示例
basic：直通生成
general：通用局部编辑
replace/person_replace：完整人物替换
style_transfer/general：全局风格迁移
返回示例
错误码
Poll
接口说明
查询视频编辑增强任务的执行状态和结果。
请求参数
返回数据
metadata metadata
请求元信息
task_id string 示例值: task-xxx
异步模式下的任务 ID。
task_status string 示例值: COMPLETED
异步模式下的任务状态。
- PENDING：提交任务排队
- RUNNING：正在运行
- COMPLETED：已完成
- FAILED：失败
- TIMEOUT：超时
business_code string 示例值: 0
业务码。
operator_id string 示例值: las_video_edit_enhance
算子 ID。
operator_version string 示例值: v1
算子版本。
error_msg string
如有异常，会返回详细错误信息。
data VideoEditEnhanceResponse
返回的数据
id string 示例值: cgt-xxxxxxxx
方舟视频生成任务 ID。
model string 示例值: doubao-seedance-2-0-260128
任务使用的模型名称和版本。
status string 示例值: succeeded
方舟任务状态：queued、running、succeeded、failed、expired。
resolution string 示例值: 1080p
生成视频的分辨率。
ratio string 示例值: adaptive
生成视频实际宽高比；adaptive 时可通过此字段获取最终比例。
duration integer 示例值: 5
生成视频实际时长（秒）；duration=-1 时可通过此字段获取模型选择的时长。
framespersecond integer 示例值: 24
生成视频帧率。
usage object
方舟返回的 token 用量。
content content
生成结果内容。
video_url string 示例值: https://{bucket}.tos-cn-beijing.volces.com/xxxx/output.mp4?X-Tos-...
生成视频的 URL，有效期 24 小时，请及时下载或转存。
last_frame_url string 示例值: https://{bucket}.tos-cn-beijing.volces.com/xxxx/last_frame.png?X-Tos-...
视频尾帧图像 URL，有效期 24 小时。仅提交时 return_last_frame=true 时返回。
template object 示例值: {"id":"replace/person_replace"}
本次任务实际使用的业务模板。返回 id，不返回提交时的 paras。
示例
请求示例
返回示例
错误码
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.10.15 19:36:39
这个页面对您有帮助吗？
有用
有用
无用
无用