Wan 2.7 -- Edit a video

POST

/services/aigc/video-generation/video-synthesis

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wan2.7-videoedit",
  "input": {
    "prompt": "Convert the entire scene to a claymation style",
    "media": [
      {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "prompt_extend": true,
    "watermark": true
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

Edit videos at up to 1080P using text prompts and optional reference images -- change styles, replace objects, or transfer content from reference images into the source video.

Authorizations

string

header

required

DashScope API Key. Get one from the QwenCloud console.

Header Parameters

enum<string>

required

Must be set to enable for asynchronous task submission.

Available options:enable

Body

application/json

enum<string>

required

Model identifier. Fixed value: wan2.7-videoedit.

Available options:wan2.7-videoedit

Example:wan2.7-videoedit

object

required

Specifies input parameters, such as the prompt.

Show child attributes

object[]

required

Media materials for editing. Each element has type and url fields.

video (required; you can provide only one video): The video to edit. Format: MP4, MOV. Duration: 2-10 seconds. Resolution: width and height in [240, 4096] pixels. Aspect ratio: 1:8 to 8:1. Max file size: 100 MB. HTTP/HTTPS URLs only.
reference_image (optional; you can provide a maximum of four reference images): Reference images for style or content transfer. Format: JPEG, JPG, PNG (no alpha channel), BMP, WEBP. Resolution: width and height in [240, 8000] pixels. Aspect ratio: 1:8 to 8:1. Max file size: 20 MB. Supports HTTP/HTTPS URLs and Base64-encoded data (data:{MIME_type};base64,{base64_data}).

Show child attributes

enum<string>

required

Media type.

video: The video to edit (required, max 1).
reference_image: A reference image (optional, max 4).

Available options:video,reference_image

string

required

URL or Base64-encoded data.

For video (type=video): Public URL (HTTP/HTTPS).

For image (type=reference_image): Public URL (HTTP/HTTPS) or Base64 string in the format data:{MIME_type};base64,{base64_data}. Supported MIME types: image/jpeg, image/png, image/bmp, image/webp.

string

A text prompt that describes the desired elements and visual features in the generated video. Supports Chinese and English, up to 5,000 characters (auto-truncated if exceeded).

Example:Convert the entire scene to a claymation style

string

Describe what to exclude from the video (e.g., low quality, blurry, extra fingers). Supports Chinese and English, up to 500 characters (auto-truncated if exceeded).

Example:low resolution, error, worst quality, low quality, incomplete, extra fingers, poor proportions

object

Video editing parameters.

Show child attributes

enum<string>

default"1080P"

Video clarity tier. Higher resolution costs more.

Actual output dimensions depend on ratio:

720P: 16:9=1280x720, 9:16=720x1280, 1:1=960x960, 4:3=1104x832, 3:4=832x1104
1080P: 16:9=1920x1080, 9:16=1080x1920, 1:1=1440x1440, 4:3=1648x1248, 3:4=1248x1648

Available options:720P,1080P

enum<string>

Aspect ratio of the output video. If omitted, uses the input video's aspect ratio.

Available options:16:9,9:16,1:1,4:3,3:4

integer

default0

Output video duration in seconds. 0 (default): use the input video's full duration without truncation. 2-10: truncate the input video to this length.

Required range:0 <= x <= 10

enum<string>

default"auto"

Audio handling for the output video.

auto (default): The model decides based on prompt. If the prompt describes sound, audio may be regenerated; otherwise the original audio is kept.
origin: Always keep the original audio without regeneration.

Available options:auto,origin

boolean

defaulttrue

Rewrite the prompt using a Large Language Model before generation. Improves results for short or vague prompts but adds latency. Set to false to use your prompt verbatim.

boolean

defaultfalse

Add an "AI Generated" watermark in the lower-right corner.

integer

Seed for reproducible results. Same seed + same parameters produces similar (not identical) output.

Required range:0 <= x <= 2147483647

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

Example:4909100c-7b5a-9f92-bfe5-xxxxxx

object

Show child attributes

string

Task ID for polling status. Use with GET /tasks/{task_id}.

Example:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

Initial task status, typically PENDING.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED