Wan โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Wan is a video generation model that supports text-to-video, first-frame / first-and-last-frame video generation, and multimodal reference generation from images (10), video (5), and audio (5). The 3.0 series supports durations of 2โ30 seconds with up to 1080P output that can be upscaled to 4K; version 2.2 is also available.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Wan |
| ModelVersion | 3.0 / 3.0-prime / 2.2 |
| Guardrail release support | Supported |
Supported Specifications by Version โ
| Version | Resolution | Ratio | Length |
|---|---|---|---|
3.0 / 3.0-prime | Default output: 480P / 720P / 1080PUpscale output: 2K / 4K | 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive | 2โ30 seconds; if there is a reference video, input+output must be 30 seconds or less |
Input Conditions โ
| Item | Condition |
|---|---|
| Output frame rate | 30fps |
| Reference image | Up to 10 images |
| Reference video | Up to 5, 15 seconds in total |
| Reference audio | Up to 5, 15 seconds in total |
3.0 is the standard version, 3.0-prime is a version with faster processing speed at the same quality, and 2.2 is the previous-generation version.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Wan |
ModelVersion | Optional | String | 3.0 / 3.0-prime / 2.2 |
Prompt | Required | String | Generation prompt |
ImageUrl | Optional | String | First frame image URL |
LastImageUrl | Optional | String | Last frame image URL. Used together with ImageUrl |
Duration | Optional | Integer | Generation length (seconds). Default value 5 |
ExtraParameters | Optional | Object | Resolution / AspectRatio |
AdditionalParameters | Optional | String | JSON string containing model-specific options. For the seed delivery format, see Additional settings |
ExtraParameters.EnablelnputComplianceCheck | Optional | Boolean | If false is explicitly passed, input moderation is released. Contact your sales representative before use |
ExtraParameters.EnableOutputComplianceCheck | Optional | Boolean | If false is explicitly passed, output moderation is released. Contact your sales representative before use |
Request Example โ
{
"ModelName": "Wan",
"ModelVersion": "3.0",
"Prompt": "a woman walks through a sunlit marketplace, camera follows behind her",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}Response Example โ
{
"Response": {
"Status": "DONE",
"Message": "ok",
"Resolution": "1920x1080",
"VideoUrls": [
"https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}Special Settings โ
Guardrail Release โ
Input and output moderation can be configured separately.
To use the guardrail release parameter, you must first contact your sales representative to confirm usage permission. Even on supported engines, guardrail release is applied only when that parameter is explicitly passed. If the parameter is omitted, it is not released.
| Parameter | Release value | Applies to |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | Input moderation release |
ExtraParameters.EnableOutputComplianceCheck | false | Output moderation release |
Merge the following settings into an existing generation request. To release both input and output moderation, pass both fields together.
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}Output Resolution โ
It is specified by Resolution and AspectRatio of ExtraParameters. The output resolution according to the specified values is as follows.
| ModelVersion | Resolution | AspectRatio | Output resolution |
|---|---|---|---|
3.0 | 1080P | 16:9 | 1920x1080 |
3.0-prime | 720P | 16:9 | 1280x720 |
2.2 | 720P | 16:9 | 1280x704 |
If you provide a first frame image, the output ratio follows the input image.
First/Last Frame Generation โ
Specify image URLs in ImageUrl and LastImageUrl respectively.
{
"ModelName": "Wan",
"ModelVersion": "3.0",
"ImageUrl": "https://<cdn>/first.png",
"LastImageUrl": "https://<cdn>/last.jpg",
"Prompt": "she opens the window and looks into the distance",
"Duration": 5,
"ExtraParameters": {
"Resolution": "720P"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}