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

算子 ID : las_video_seedance_replace

应用场景 #

核心能力 #

• 当前版本支持场景替换（scene_replace） 、物体替换（object_replace）、人物替换（person_replace）这几类视频智能编辑任务。
  • 场景替换（scene_replace） ：保持原视频中的人物、商品、动作和镜头结构，替换背景或环境风格。
  • 物体替换（object_replace） ：基于参考图片将视频中的目标物体替换为指定样式或商品。
  • 人物替换（person_replace）：基于参考图片将视频中的目标人物替换为指定人物。

    注意

    • 使用人物替换功能时，您需同步申请开通 LAS 素材资产管理功能（白名单功能，默认关闭），提交人物替换任务时同步设置seedance_use_asset_api = true 。
    • 人物替换所需输入的音视频或图片素材：
      • 您可以先手动上传至 LAS 素材库，提交任务时通过 LAS 素材 ID 的方式输入给算子。
      • 也可以直接通过 HTTPS 或 TOS 路径等方式输入给算子，此场景下，LAS 会自动为您将素材上传至 LAS 素材管理中并使用素材 ID 作为输入，算子任务完成后会自动清理本次自动上传的素材。
• 视频编辑结果质量与稳定性保障。
  • 支持通过 user_prompt 补充自然语言编辑约束，例如保留动作、移除水印、避免字幕或控制风格细节。
  • 支持有限次数的自动评估与重试，帮助在复杂素材上获得更稳定的替换结果。
  • 支持返回最终视频结果和诊断文件（result.json ），便于调用方留存生成结果与过程信息。

效果展示 #

支持的地域 #

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

算子性能 #

输入要求 #

输出要求 #

• 计费标准

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

  注意

  • 每次任务支付的总费用：除单价外，还与输入/输出视频的时长、输入/输出视频的分辨率有关。
  • 如果您开启了根据评估结果触发重试（"enable_retry"= "true"），则触发任务重试时，每次重试均会新提交一个任务，会单独计费一次。
    例如，您的任务运行后，评估结果不达标，又重试了2次，则最终会产生 3 个视频编辑任务的费用。
  • 仅成功生成视频的任务会产生费用，因审核等运营导致视频生成失败的场景不收取费用。

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

  注意

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

  版本细分	单价	计费项：视频时长	时长折算系数：与视频分辨率有关
  基础版	1.6 元/秒	（输入视频时长+输出视频时长）/2	seedance_model设置为 seedance 2.0-fast 480P：0.554 720P：1.220
  			seedance_model设置为 seedance 2.0-mini 480P：0.176875 720P：0.38125
  增强版	2 元/秒	（输入视频时长+输出视频时长）/2	seedance_model设置为 seedance 2.0 480P：0.580 720P：1.220 1080P：3.040 4k：5.075
  			seedance_model设置为 seedance 2.5 480P：0.808 720P：1.814

• 计费示例

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

• 出账计费单元
  当前调用本算子产生的费用账单，在账单明细中展示的计费单元为“视频生成增强版”，您在查看账单时可关注下此差异。

API 调用说明 #

• 本算子的 API 为异步任务接口，您需要通过 submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。同时，本算子支持异步回调能力（Callback），您可在发起算子调用任务时设置回调参数callback.url，LAS 会向该 URL 发送 HTTP POST 通知，异步回调的使用指导可参见 异步回调 API。
• 任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit #

接口说明 #

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

请求参数 #

返回数据 #

请求示例 #

# 请将 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": ""
  }
}

错误码 #

Poll #

接口说明 #

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

请求参数 #

返回数据 #

请求示例 #

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",
        "submit_time": "2026-07-21T16:04:06+08:00",
        "end_time": "2026-07-21T16:04:06+08:00",
        "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"
    }
}

错误码 #