# Singapore (ap-southeast-1). For another region, replace ap-southeast-1 in the URL.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --location 'https://ap-southeast-1.maas.qwencloudapi.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"
}
}Authorizations
DashScope API Key. Get one from the QwenCloud console.
Header Parameters
Must be set to enable for asynchronous task submission.
Body
application/jsonModel identifier. Fixed value: wan2.7-videoedit.
Specifies input parameters, such as the prompt.
Show child attributes
Show child attributes
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
Show child attributes
Media type.
video: The video to edit (required, max 1).reference_image: A reference image (optional, max 4).
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.
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).
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).
Video editing parameters.
Show child attributes
Show child attributes
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
Aspect ratio of the output video. If omitted, uses the input video's aspect ratio.
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.
Audio handling for the output video.
auto(default): The model decides based onprompt. If the prompt describes sound, audio may be regenerated; otherwise the original audio is kept.origin: Always keep the original audio without regeneration.
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.
Add an "AI Generated" watermark in the lower-right corner.
Seed for reproducible results. Same seed + same parameters produces similar (not identical) output.
Response
Unique request identifier for tracing and troubleshooting.