POST /v2/videos/generations

Method: POSTEndpoint: /v2/videos/generations

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

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

prompt
string
Required
model
enum<string>
Required
Value:
wan2.5-i2v-preview
  // provider-specific example normalized for English documentation
  // provider-specific example normalized for English documentation
duration
enum<integer>
Optional
Enum Values:
5
10
resolution
enum<string>
Optional
  // provider-specific example normalized for English documentation
Enum Values:
720P
480P
1080P
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。
audio
string
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.
images
array
[string]
Required
  // provider-specific example normalized for English documentation
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).
watermark
boolean
Optional
template
string
Optional
negative_prompt
string
Optional
prompt_extend
string
Optional
seed
integer
Optional
Example
{
"model"
:
"wan2.5-i2v-preview"
,
"prompt"
:
  // provider-specific example normalized for English documentation
,
"images"
:
[
"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"
,
"resolution"
:
"480P"
,
"prompt_extend"
:
true
,
"duration"
:
5
}

Example Request

Shell

curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.5-i2v-preview",
    "prompt": "Example prompt from provider documentation.",
    "images": [
        "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",
    "resolution": "480P",
    "prompt_extend": true,
    "duration": 5
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

task_id
string
Required

Example

{
    "task_id": "e7bed961-d1b9-4b3f-8ef9-5f441bde28c8"
}