You need to enable JavaScript to run this app.
Lake AI Service

Lake AI Service

Copy page
Download PDF
Video Generation
Video Edit Enhanced 2.0
Copy page
Download PDF
Video Edit Enhanced 2.0

The Video Edit Enhanced 2.0 operator (las_video_edit_enhance) provides business-oriented editing templates on top of Seedance's video generation capabilities. Requests use template.id to select a server-maintained processing workflow, enabling direct generation, general keyframe editing, face swapping, complete character replacement, or global style transfer while preserving the original video's actions, shots, composition, and timeline.

Operator introduction

Operator ID: las_video_edit_enhance

Core capabilities

  • Template-based routing: The business only specifies the editing target, and the server-side template is responsible for selecting the VLM, keyframe redraw, structural video, and Seedance prompt assembly workflow.
  • General keyframe editing: VLM interprets the video and user intent, selects keyframes, and uses Seedream to edit based on the source frame canvas.
  • Full character replacement: Uses the original video as the basis for actions and timeline, locking the final character appearance with the target character image and redrawn keyframes.
  • Style transfer: By default, uses pure depth structural video to preserve spatial layout, actions, and camera movement, reducing interference from the original video's color, material, subtitles, and cinematographic style.
  • Multi-subject mapping: Multiple source subjects in user_prompt can be bound to different target images in image_urls respectively.
  • Controllable fallback: When allow_fallback=true, preprocessing failures can fall back to direct generation equivalent to basic; for strong semantic editing, it is recommended to set it to false to avoid returning incomplete editing results.

Supported preset templates

The supported template types and applicable scenarios are as follows.

template.id

Applicable scenarios

Reference image requirements

Unsuitable scenarios

basic

To skip VLM, frame extraction, and redraw, and directly request Seedance when complete prompts and reference materials are already prepared.

Optional

To have the operator understand the editing object, automatically extract frames, or lock person identity.

general

General keyframe editing, such as local removal, movement, attribute modification, or hybrid editing not yet covered by dedicated templates.

At least 1 image

Dedicated templates should be used for scenarios such as pure face swapping, complete person replacement, explicit object/background replacement, or global style transfer.

replace/person_replace

Fully replace one or more characters, including the target character's face, hairstyle, body shape, clothing, and accessories, while retaining the original video's actions and positions. For multi-character scenarios, it is recommended to use the seedance-2-5 model.

At least one target person image is required.

Face swap only, or only replace object/background.

style_transfer/general

Convert the entire video to a unified visual style such as Japanese manga, Korean manga, Chinese manga, 3D animation, or photorealism, while maintaining content and sequence.

Optional; can be provided if there is a style reference image.

Only replace a specific person or object without changing the overall visual medium.

Template boundaries:

  • To replace only characters, use replace/person_replace.
  • Use style_transfer/general only to change global visual media and style; do not use style transfer templates when editing only local subjects.
  • general is the general fallback template. When a dedicated template can more clearly constrain person identity, replacement scope, and video structure, the dedicated template should be preferred.

Supported regions

  • Beijing: cn-beijing

Operator performance

Subcategories
Performance impact description

Maximum RPM

600

Maximum concurrency

10

Processing time

  • Total processing time depends on video duration, number of keyframes, number of reference images, template, and downstream model queue status. basic does not perform preprocessing and usually has the shortest processing time.

Input and output requirements

Input requirements

Subdivision
Detailed description

Supported input data modalities

  • Video
  • Image
  • Audio
  • Text

Input path requirements

Provide input data to the operator via request parameters video_url, image_urls, and audio_url. Currently, public URLs, TOS paths, and LAS asset IDs are supported.

  • Public URL: A video URL accessible via the public internet, in the format http/https.
  • TOS path: After uploading the data to be processed to a TOS Bucket under the same primary account and region as the current LAS service, you can provide the TOS path in the format tos://bucket_name/demo.
  • LAS asset ID: The ID used for generating real and virtual avatars in videos, following the format: asset://<asset-id>.
    • When using the LAS asset ID method, you must first apply to enable the LAS asset managementfeature (allowlist feature, disabled by default), and set seedance_use_asset_api = true when submitting the task.
    • When submitting various tasks, if the input material involves real audio/video or images, you must first upload the material to the LAS asset library and input the corresponding material to the model via the LAS asset ID method; otherwise, the task may be blocked.
    • After enabling the feature and uploading materials, you can view the list of asset groups in the LAS console under asset management > Virtual Portrait Asset. On the asset group details page, you can obtain the specific asset ID (asset-id), which can be concatenated in the above format as the operator's input.

Output requirements

Subdivision
Detailed description

Output data modality

  • Video

Output format: Video

  • Aspect ratio: Original video ratio (default), 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.
  • Resolution: Supports setting to 480p, 720p, 1080p, 4k (4k is supported only in seedance 2.0).

Output path: TOS

Specify the storage path for the operator's output results via the request parameter output_tos_path. Currently, only TOS paths are supported.

  • TOS path: A directory in a TOS Bucket under the same primary account and region as the LAS service, with write permissions.

Billing information
  • Billing standards

    Breakdown
    Billing standards description

    Billing items

    Includes video preprocessing and video editing as two billing items. Both billing items are charged based on usage calculated from the input/output video duration.

    • Video preprocessing billing:
      • Depends on the type of video editing task template selected when submitting the task. When submitting an operator task, set the processing template of the task using the template request parameter. The video preprocessing billing unit price of different task templates varies.
      • For video preprocessing billing, usage is calculated based on the output video duration.
    • Video editing billing:
      • Depends on the type of task processing model selected when submitting the task. When submitting an operator task, set the processing model of the task using the model request parameter. The video editing billing unit price of different models varies.
      • For video editing billing, usage is calculated as the sum of the input and output video durations.

    The final total cost is the sum of the video preprocessing and video editing billing items.

    Billing type

    Pay-as-you-go billing, unit: CNY/second, billed hourly based on actual usage. Billing precision: Rounded.

    Unit price

    • Video preprocessing unit price: 0.16 CNY/second
    • Video editing unit price details: depend on the model type and video resolution you select. See the table below for details.

    warning

    • For each task, the video editing fee depends not only on the unit price, but also on the input/output video duration and the input/output video resolution.
    • Fees are incurred only for tasks that successfully generate videos. No fees are charged for scenarios where video generation fails due to review or other operational reasons.
  • Billing details
    Billing estimate: Total cost ≈ video preprocessing fee + video editing fee = video preprocessing unit price * output video duration + video editing unit price * (input video duration + output video duration)

    warning

    The above formula is for cost estimation only; actual billing is based on the calculated amount in the invoice.

    • Video preprocessing unit price: 0.16 CNY/second

    • Video editing unit price details: depend on the model type and video resolution you select. Details are as follows.

      Model

      Video resolution

      List price

      seedance_2.0_fast

      480p

      0.442 CNY/second

      720p

      0.95 CNY/second

      seedance_2.0_mini

      480p

      0.282 CNY/second

      720p

      0.605 CNY/second

      seedance_2.0

      480p

      0.562 CNY/second

      720p

      1.208 CNY/second

      1080p

      3.014 CNY/second

      4k

      6.22 CNY/second

      seedance_2.5

      480p

      0.806 CNY/second

      720p

      1.814 CNY/second

  • Billing example

    • Example scenario: Using the replace/person_replace task template and the Seedance 2.0 model to perform video face replacement editing, with an input video duration of 10 seconds and a resolution of 1080p.
    • Cost details:
      Total cost ≈ video preprocessing fee + video editing fee = 0.16 CNY/second * 10 seconds + 3.014 CNY/second * (10 seconds + 10 seconds) = 61.88 CNY

Caution and prerequisites

Details

Caution and prerequisites

Costs

Before calling an operator, you need to understand the model invocation costs associated with using the operator. For details, see Large model invocation billing.

Authentication (API Key)

Before calling an operator, you need to generate an API Key for operator invocation. It is recommended to configure the API Key as an environment variable to ensure safer operator calls. For details, see Obtain and configure API Key.

BaseURL

Before calling an operator, you need to determine the BaseURL for operator invocation based on the region where your current LAS service is deployed. This is used to configure the path parameter values for operator calls.
For details, see Obtain the Base URL. The Examples below are for reference only; when making actual calls, replace the path values with those corresponding to your region.

Rest API invocation

API invocation instructions

  • The API for this operator is an asynchronous task interface. You need to submit a task via the submit interface to obtain the task_id, then use the Poll interface to check the status of the corresponding task (task_id) and retrieve the operator processing result. Additionally, this operator supports asynchronous callback capability (Callback). You can set the callback parameter callback.url when initiating an operator task. LAS will send an HTTP POST notification to this URL. For guidance on using asynchronous callbacks, see Asynchronous callback API.
  • After the task is submitted, the task_id is valid for 3 days. After 3 days, you will not be able to obtain the operator processing result using this task_id.

Submit

Interface description

Invoke the Video Edit Enhanced 2.0 operator (las_video_edit_enhance) to submit an asynchronous task. The operator uses template.id to select a server-maintained business workflow, enabling direct generation, general keyframe editing, face swapping, complete character replacement, or global style transfer while preserving the original video's actions, shots, composition, and timeline.

Request parameters

Parameter
Type
Required
Example value
Description
operator_id
string
Yes
las_video_edit_enhance
Fixed operator ID
operator_version
string
Yes
v1
Fixed operator version
data
VideoEditEnhanceReqParams
Yes
-
Video Edit Enhance request parameters

Response parameters

Parameter
Type
Example value
Description
metadata
metadata
-
Asynchronous task metadata

Example

Request example
basic: Direct generation

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: General local editing

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: Complete person replacement

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: Global style transfer

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
  }
}'

Response example

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

Error code

HttpStatusCode

Error code

Error message

Description

400

Url.Invalid

The url is invalid.

Invalid reference to video, image, or audio

400

Parameter.Invalid

The parameter is invalid.

Template does not exist, template parameter not supported, required reference image missing, or invalid generation parameter

400

Model.InvalidName

The model name is invalid.

Invalid Seedance model name

400

Video.DownloadFailed

Video download failed.

Video download failed

400

Tos.AccessFailed

TOS access failed.

TOS access failed

401

Authorization.Missing

Missing Authorization.

Missing authentication information

401

ApiKey.Invalid

The api key is invalid.

API Key is invalid

500

Internal.ServerError

Internal server error.

Video understanding, image generation, video generation, or result assembly failed

Poll

Interface description

Query the execution status and result of the Video Edit Enhanced task.

Request parameters

Name

Type

Required

Example value

Description

operator_id

string

Yes

las_video_edit_enhance

Operator ID

operator_version

string

Yes

v1

Operator version

task_id

string

Yes

task-xxx

Task ID

Response parameters

Parameter
Type
Example value
Description
metadata
metadata
Request metadata.
data
VideoEditEnhanceResponse
Video editing task result.

Example

Request example

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"
}'

Response example

{
  "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-..."
    }
  }
}

Error code

HttpStatusCode

Error code

Error message

Description

400

Parameter.Invalid

The parameter is invalid.

Invalid parameter, for example, task_id is missing.

401

Authorization.Missing

Missing Authorization.

Authentication is missing.

401

ApiKey.Invalid

The api key is invalid.

API is invalid.

500

Internal.ServerError

Internal server error.

Internal server error.

Last updated: 2026.09.10 19:18:39