POST /qwen/api/v1/services/aigc/image2video/video-synthesis

Method: POSTEndpoint: /qwen/api/v1/services/aigc/image2video/video-synthesis

Official API Documentation

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

Request Parameters

Header Parameters

X-DashScope-Async
string
Required
Example:
enable
Content-Type
string
Required
Example:
application/json
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json Required

model
string
Required
input
object
Required
first_frame_url
string
Required
  // provider-specific example normalized for English documentation
Image limits:
Image formats: JPEG, JPG, PNG (transparent channels are not supported), BMP, WEBP.
Image resolution: width and height must each be in the range [360, 2000] pixels.
File size: up to 10 MB.
Input image notes:
Use a publicly accessible URL
Supports HTTP or HTTPS. Local files can be uploaded first to obtain a temporary URL.
Example Value：
https://wanx.alicdn.com/material/20250318/first_frame.png。
String content after passing in a Base64-encoded image.
Data format: data:{MIME_type};base64,{base64_data}.
Example Value：data:image/png;base64,GDU7MtCZzEbTbmRZ......。
last_frame_url
string
Optional
  // provider-specific example normalized for English documentation
Image limits:
Image formats: JPEG, JPG, PNG (transparent channels are not supported), BMP, WEBP.
  // provider-specific example normalized for English documentation
File size: up to 10 MB.
Input image notes:
Use a publicly accessible URL
Supports HTTP or HTTPS. Local files can be uploaded first to obtain a temporary URL.
Example Value：
https://wanx.alicdn.com/material/20250318/last_frame.png。
  // provider-specific example normalized for English documentation
Data format: data:{MIME_type};base64,{base64_data}.
  // provider-specific example normalized for English documentation
prompt
string
Optional
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
negative_prompt
string
Optional
Negative prompt used to describe what should not appear in the video, helping constrain the visual result.
Supports both Chinese and English, with a maximum length of 500 characters. Excess content is truncated automatically.
Example Value: low resolution, errors, worst quality, low quality, mutilation, extra fingers, bad proportions, etc.
template
string
Optional
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
parameters
object
Required
resolution
string
Optional
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
Example Value：720P。
duration
integer
Optional
Video generation duration in seconds. The value is currently fixed at 5 and cannot be changed. The model always generates a 5-second video.
watermark
boolean
Optional
Whether to add a watermark. The watermark appears in the lower-right corner and reads "AI-generated".
false: default value, no watermark is added.
true: add a watermark.
Example Value：false。
prompt_extend
boolean
Optional
Whether to enable prompt rewriting. When enabled, a large model rewrites the input prompt automatically. This often improves results for short prompts, but it also increases latency.
true: default value, enables smart rewriting.
false: disables smart rewriting.
Example Value：true。
seed
integer
Optional
  // provider-specific example normalized for English documentation
If omitted, the system generates a random seed automatically. To improve reproducibility, keep the seed fixed.
Because model generation is probabilistic, using the same seed does not guarantee identical results every time.
Example Value：12345。
Example
{
"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"
:
  // provider-specific example normalized for English documentation
}
,
"parameters"
:
{
"resolution"
:
"480P"
,
"prompt_extend"
:
true
}
}

Example Request

Shell

curl --location --request POST '/qwen/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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": "Example prompt from provider documentation."
    },
    "parameters": {
        "resolution": "480P",
        "prompt_extend": true
    }
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{}