Wan — Animate from first & last frames

POST

/services/aigc/image2video/video-synthesis

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wan2.2-kf2v-flash",
  "input": {
    "first_frame_url": "https://wanx.alicdn.com/material/20250318/first_frame.png",
    "last_frame_url": "https://wanx.alicdn.com/material/20250318/last_frame.png",
    "prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view."
  },
  "parameters": {
    "resolution": "480P",
    "prompt_extend": true
  }
}'

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

The Wan kf2v model generates a smoothly transitioning video from a first frame image, a last frame image, and a text prompt.

Authorizations

string

header

required

DashScope API Key. Create one in the Qwen Cloud console.

Header Parameters

enum<string>

required

Must be set to enable for asynchronous task submission. Returns an error if not included.

Available options:enable

Body

application/json

enum<string>

required

Model name.

Available options:wan2.2-kf2v-flash,wan2.1-kf2v-plus

Example:wan2.2-kf2v-flash

object

required

Input data including frame images and optional prompt.

Show child attributes

string

required

URL of the first frame image. The output video aspect ratio matches this image. Must be publicly accessible (HTTP or HTTPS). Image requirements: Format: JPEG, JPG, PNG (no alpha), BMP, or WEBP. Resolution: 360-2000 px per side. Max file size: 10 MB.

Example:https://wanx.alicdn.com/material/20250318/first_frame.png

string

required

URL of the last frame image. Must be publicly accessible (HTTP or HTTPS). Resolution may differ from the first frame; alignment is not required. Image requirements: Format: JPEG, JPG, PNG (no alpha), BMP, or WEBP. Resolution: 360-2000 px per side. Max file size: 10 MB.

Example:https://wanx.alicdn.com/material/20250318/last_frame.png

string

Text prompt describing the desired video content. Supports Chinese and English. Maximum 800 characters; excess is auto-truncated. If the subject or scene changes between the first and last frames, describe the transition (e.g., camera movement or subject movement).

Example:Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.

Required range:length <= 800

string

Describes content you do NOT want in the video. Supports Chinese and English. Maximum 500 characters; excess is auto-truncated.

Example:low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions

Required range:length <= 500

object

Video generation parameters.

Show child attributes

enum<string>

default"720P"

Resolution tier for the generated video. Adjusts definition (total pixels) without changing aspect ratio. The video aspect ratio matches the first frame image. Resolution affects cost: 1080P > 720P > 480P. Available values depend on the model: wan2.2-kf2v-flash: 480P, 720P, 1080P (default: 720P). wan2.1-kf2v-plus: 480P, 720P (default: 720P).

Available options:480P,720P,1080P

Example:720P

enum<integer>

default5

Duration of the generated video in seconds. Fixed at 5; cannot be changed.

Available options:5

boolean

defaulttrue

Enable prompt rewriting. When enabled, a large language model rewrites the input prompt to improve results for short prompts, but increases processing time. Default: true.

boolean

defaultfalse

Add an "AI-generated" watermark to the bottom-right corner of the video. Default: false.

integer

Random number seed for reproducibility. Range: [0, 2147483647]. If omitted, a random seed is used. Results may still vary due to model randomness.

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}. Valid for 24 hours.

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

enum<string>

Initial task status, typically PENDING.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN