|
#### Request parameters
##### Headers
Content-Type `string` (Required)
The content type of the request. Must be `application/json`.
Authorization `string` (Required)
Authenticates the request with a Model Studio API key. Example: Bearer sk-xxxx.
X-DashScope-Async `string` (Required)
Enables asynchronous processing. HTTP requests support only asynchronous calls. Must be `enable`.
If this request header is missing, the error "current user api does not support synchronous calls" is returned.
##### Request body
model `string` (Required)
The model name. Available models and pricing: [model pricing](/help/en/model-studio/model-pricing).
Example: wan2.6-i2v-flash.
input `object` (Required)
Input fields including the prompt.
prompt `string` (Optional)
Describes the desired visual elements and characteristics of the generated video.
Supports Chinese and English. Each character counts as one. Text exceeding the limit is truncated. Length limits by model:
- Wan2.6 and Wan2.5 series models: A maximum of 1,500 characters.
- wan2.2 and wan2.1 series models: A maximum of 800 characters.
Example: A kitten running on the grass.
Prompt writing tips: [Text-to-Video/Image-to-Video Prompt Guide](/help/en/model-studio/text-to-video-prompt).
negative\_prompt `string` (Optional)
Describes what to exclude from the video, constraining the output.
Supports Chinese and English. Maximum 500 characters; longer text is truncated.
Example: low resolution, errors, worst quality, low quality, disfigured, extra fingers, poor proportions, etc.
img\_url `string` (Required)
The URL or Base64-encoded data of the initial image.
Image constraints:
- Image format: JPEG, JPG, PNG (alpha channel not supported), BMP, or WEBP.
- Image resolution: Both width and height must be within \[240, 8000] pixels.
- File size:
- Wan2.6 and Wan2.5 series models: A maximum of 20 MB.
- wan2.2 and wan2.1 series models: A maximum of 10 MB.
Supported input formats:
1. Public URL:
- Supports HTTP and HTTPS protocols.
- Example: [https://cdn.translate.alibaba.com/r/wanx-demo-1.png](https://cdn.translate.alibaba.com/r/wanx-demo-1.png).
2. Base64-encoded image string:
- Data format: `data:{MIME_type};base64,{base64_data}`.
- Example: data:image/png;base64,GDU7MtCZzEbTbmRZ...... (truncated for brevity).
- For details, see [Input Image](/help/en/model-studio/image-to-video-guide#32d9db99f1fk0).
audio\_url `string` (Optional)
Supported models: Wan2.6 and Wan2.5 series models.
The URL of the audio file. The model generates the video using this audio.
Supported input formats:
1. Public URL:
- Supports HTTP and HTTPS protocols.
- Example: [https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp3](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp3).
Audio constraints:
- Format: WAV, MP3.
- Duration: 3–30s.
- File size: A maximum of 15 MB.
- Out-of-range handling: If the audio duration exceeds the specified `duration` (5 or 10 seconds), the system automatically truncates the audio to the first 5 or 10 seconds, and the rest is discarded. If the audio is shorter than the video duration, the video is silent after the audio ends. For example, if the audio is 3 seconds long and the video duration is 5 seconds, the first 3 seconds of the output video will have sound, and the last 2 seconds will be silent.
Example: [https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3).
parameters `object` (Optional)
Controls for resolution, duration, intelligent prompt rewriting, and watermarks.
resolution `string` (Optional)
Resolution directly affects cost. Before you call the API, confirm the [model pricing](/help/en/model-studio/model-pricing).
Specifies the output video resolution tier. The model scales the output to a similar total pixel count based on the selected tier. The model maintains the output aspect ratio as close as possible to that of the input image in`img_url`. For details, see [FAQ](/help/en/model-studio/legacy-image-to-video-api-reference#2b6ac4aea9h5n).
The default value and available enum values for this parameter depend on the `model` parameter, as follows:
- wan2.6-i2v-flash: Valid values: 720P, 1080P. Default value: `1080P`.
- wan2.6-i2v: Valid values: 720P, 1080P. Default value: `1080P`.
- wan2.6-i2v-us: Valid values: 720P, 1080P. Default value: `1080P`.
- wan2.5-i2v-preview: Valid values: 480P, 720P, 1080P. Default value: `1080P`.
- wan2.2-i2v-flash: Valid values: 480P, 720P. Default value: `720P`.
- wan2.2-i2v-plus: Valid values: 480P, 1080P. Default value: `1080P`.
- wan2.1-i2v-turbo: Valid values: 480P, 720P. Default value: `720P`.
- wan2.1-i2v-plus: Valid values: 720P. Default value: `720P`.
Example: 1080P.
duration `integer` (Optional)
Duration directly affects cost. Before you call the API, confirm the [model pricing](/help/en/model-studio/model-pricing).
The output video duration, in seconds. Valid values depend on the `model` parameter:
- wan2.6-i2v-flash: An integer in \[2, 15]. Default: 5.
- wan2.6-i2v: An integer in \[2, 15]. Default: 5.
- wan2.6-i2v-us: Valid values: 5, 10, 15. Default: 5.
- wan2.5-i2v-preview: Valid values: 5, 10. Default: 5.
- wan2.2-i2v-plus: Fixed at 5 seconds and cannot be modified.
- wan2.2-i2v-flash: Fixed at 5 seconds and cannot be modified.
- wan2.1-i2v-plus: Fixed at 5 seconds and cannot be modified.
- wan2.1-i2v-turbo: Valid values: 3, 4, or 5. Default: 5.
Example: 5.
prompt\_extend `boolean` (Optional)
Whether to enable prompt rewriting. When enabled, an LLM rewrites the input prompt. This improves generation quality for shorter prompts but increases processing time.
- true (default)
- false
Example: true.
shot\_type `string` (Optional)
Supported models: Wan2.6 series models.
Specifies the shot type of the generated video: a single continuous shot or a sequence of multiple shots.
This parameter takes effect only when `"prompt_extend": true`.
Parameter priority: `shot_type > prompt`. For example, if shot\_type is set to "single", even if the prompt contains "generate a multi-shot video", the model will still output a single-shot video.
Valid values:
- single: Default value. Generates a single-shot video.
- multi: Generates a multi-shot video.
Example: single.
Use this parameter when you need strict control over the narrative structure, such as a single shot for product demos or multiple shots for short films.
audio `boolean` (Optional)
This affects cost. Videos with sound and silent videos have different prices. Check pricing in the Model Studio console.
Supported model: wan2.6-i2v-flash.
Specifies whether to generate a video with sound.
Parameter priority: `audio > audio_url`. When `audio=false`, the output is still a silent video even if an `audio_url` is provided, and billing is based on a silent video.
Valid values:
- true: Default value. Generates a video with sound.
- false: Generates a silent video.
Example: true.
watermark `boolean` (Optional)
Specifies whether to add an "AI Generated" watermark in the lower-right corner of the video.
- false: Default value. No watermark is added.
- true: Adds a watermark.
Example: false.
seed`integer`(Optional)
The random number seed. Value range: `[0, 2147483647]`.
If not specified, the system generates one. For better reproducibility, use a fixed seed.
Generation is probabilistic. Even with the same seed, results may differ.
Example: 12345.
|
This feature is supported only by the Wan2.6 series models.
You can enable it by setting `"prompt_extend": true` and `"shot_type":"multi"`.
```bash
# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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.6-i2v-flash",
"input": {
"prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A boy made of spray paint comes to life from a concrete wall. He raps an English song at high speed while striking a classic, energetic rapper pose. The scene is set under an urban railway bridge at night. The lighting comes from a single street lamp, creating a cinematic atmosphere full of high energy and amazing detail. The audio of the video consists entirely of his rap, with no other dialogue or noise.",
"img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
"audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
},
"parameters": {
"resolution": "720P",
"prompt_extend": true,
"duration": 10,
"shot_type":"multi"
}
}'
```
This feature is supported only by the Wan2.6 and Wan2.5 series models.
If you do not provide `input.audio_url`, the model automatically generates matching background music or sound effects based on the video content.
```bash
# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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.5-i2v-preview",
"input": {
"prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A boy made of spray paint comes to life from a concrete wall. He raps an English song at high speed while striking a classic, energetic rapper pose. The scene is set under an urban railway bridge at night. The lighting comes from a single street lamp, creating a cinematic atmosphere full of high energy and amazing detail. The audio of the video consists entirely of his rap, with no other dialogue or noise.",
"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
}
}'
```
This feature is supported only by the Wan2.6 and Wan2.5 series models.
To specify background music or a voiceover for the video, pass the URL of your custom audio file in the `input.audio_url` parameter.
```bash
# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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.5-i2v-preview",
"input": {
"prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A boy made of spray paint comes to life from a concrete wall. He raps an English song at high speed while striking a classic, energetic rapper pose. The scene is set under an urban railway bridge at night. The lighting comes from a single street lamp, creating a cinematic atmosphere full of high energy and amazing detail. The audio of the video consists entirely of his rap, with no other dialogue or noise.",
"img_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
"audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
},
"parameters": {
"resolution": "480P",
"prompt_extend": true,
"duration": 10
}
}'
```
Only the following models support generating a silent video:
- wan2.6-i2v-flash: To generate a silent video, you must explicitly set `parameters.audio = false`.
- wan2.2 and wan2.1 series models: Generate silent videos by default; no additional parameters are required.
```bash
# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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.2-i2v-plus",
"input": {
"prompt": "A cat running on the grass",
"img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
},
"parameters": {
"resolution": "480P",
"prompt_extend": true
}
}'
```
Use the negative\_prompt parameter to prevent "flowers" from appearing in the generated video.
```bash
# The following URL is for the Singapore region. Replace {WorkspaceId} with your actual workspace ID. URLs differ by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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.2-i2v-plus",
"input": {
"prompt": "A cat running on the grass",
"negative_prompt": "flowers",
"img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
},
"parameters": {
"resolution": "480P",
"prompt_extend": true
}
}'
```
|
](https://cdn.translate.alibaba.com/r/wanx-demo-1.png){kind=link}