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 ID: las_video_edit_enhance
user_prompt can be bound to different target images in image_urls respectively.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.The supported template types and applicable scenarios are as follows.
| Applicable scenarios | Reference image requirements | Unsuitable scenarios |
|---|---|---|---|
| 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 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. |
| 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. |
| 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:
replace/person_replace.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.Subcategories | Performance impact description |
|---|---|
Maximum RPM | 600 |
Maximum concurrency | 10 |
Processing time |
|
Subdivision | Detailed description |
|---|---|
Supported input data modalities |
|
Input path requirements | Provide input data to the operator via request parameters
|
Subdivision | Detailed description |
|---|---|
Output data modality |
|
Output format: Video |
|
Output path: TOS | Specify the storage path for the operator's output results via the request parameter
|
Billing standards
Breakdown | Billing standards description |
|---|---|
Billing items | Includes
The final total cost is the sum of the |
Billing type | Pay-as-you-go billing, unit: CNY/second, billed hourly based on actual usage. Billing precision: Rounded. |
Unit price |
|
warning
video editing fee depends not only on the unit price, but also on the input/output video duration and the input/output video resolution.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
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.Total cost ≈ video preprocessing fee + video editing fee = 0.16 CNY/second * 10 seconds + 3.014 CNY/second * (10 seconds + 10 seconds) = 61.88 CNYDetails | 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. |
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.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.
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 |
Parameter | Type | Example value | Description |
|---|---|---|---|
metadata | metadata | - | Asynchronous task metadata |
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": "" } }
HttpStatusCode | Error code | Error message | Description |
|---|---|---|---|
400 |
| The url is invalid. | Invalid reference to video, image, or audio |
400 |
| The parameter is invalid. | Template does not exist, template parameter not supported, required reference image missing, or invalid generation parameter |
400 |
| The model name is invalid. | Invalid Seedance model name |
400 |
| Video download failed. | Video download failed |
400 |
| TOS access failed. | TOS access failed |
401 |
| Missing Authorization. | Missing authentication information |
401 |
| The api key is invalid. | API Key is invalid |
500 |
| Internal server error. | Video understanding, image generation, video generation, or result assembly failed |
Query the execution status and result of the Video Edit Enhanced task.
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 |
Parameter | Type | Example value | Description |
|---|---|---|---|
metadata | metadata | Request metadata. | |
data | VideoEditEnhanceResponse | Video editing task result. |
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-..." } } }
HttpStatusCode | Error code | Error message | Description |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid. | Invalid parameter, for example, |
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. |