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

Method: POSTEndpoint: /qwen/api/v1/services/aigc/video-generation/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.

Audio capabilities: supports automatic dubbing or a custom audio file for audio-video synchronization. Available only on wan2.5.

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
prompt
string
Optional
  // provider-specific example normalized for English documentation
Chinese and English are both supported. Each Chinese character or Latin letter counts as one character, and content beyond the limit is truncated automatically. Length limits vary by model version:
  // provider-specific example normalized for English documentation
For wan2.2 and earlier models: maximum length is 800 characters.
  // 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.
img_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://cdn.translate.alibaba.com/r/wanx-demo-1.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...... (the encoded string is truncated for display).
  // provider-specific example normalized for English documentation
audio_url
string
Optional
  // provider-specific example normalized for English documentation
Supports HTTP or HTTPS. Local files can be uploaded first to obtain a temporary URL.
Audio limits:
Formats: wav and mp3.
Duration: 3 to 30 seconds.
File size: up to 15 MB.
Over-limit handling: if the audio is longer than the duration value of 5s or 10s, only the first 5s or 10s are kept and the rest is discarded. If the audio is shorter than the video duration, the remaining part of the video is silent. For example, if the audio is 3s and the video is 5s, the output has sound for the first 3s and is silent for the last 2s.
Example Value：
https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3。
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
Optional
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
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
Example Value：1080P。
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。
duration
integer
Optional
Video duration in seconds. The allowed values depend on the model parameter:
  // 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
  // provider-specific example normalized for English documentation
Example Value：5。
watermark
boolean
Optional
Whether to add a watermark. The watermark appears in the lower-right corner of the video and always reads "AI-generated".
false: default value, no watermark is added.
true: add a watermark.
Example Value：false。
audio
boolean
Optional
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
true: default value, automatically adds audio to the video.
false: no audio is added; the output video is silent.
Example Value：true。
seed
integer
Optional
Random seed. Range: [0, 2147483647].
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.5-i2v-preview"
,
"input"
:
{
"prompt"
:
  // provider-specific example normalized for English documentation
,
"img_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
}
,
"parameters"
:
{
"resolution"
:
"480P"
,
"prompt_extend"
:
true
,
"duration"
:
10
,
"audio"
:
true
}
}

Example Request

Shell

curl --location --request POST '/qwen/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.5-i2v-preview",
    "input": {
        "prompt": "Example prompt from provider documentation.",
        "img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
    },
    "parameters": {
        "resolution": "480P",
        "prompt_extend": true,
        "duration": 10,
        "audio": true
    }
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{}