Skip to content

Wan โ€‹

Updated

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 โ€‹

ItemValue
ModelNameWan
ModelVersion3.0 / 3.0-prime / 2.2
Guardrail release supportSupported

Supported Specifications by Version โ€‹

VersionResolutionRatioLength
3.0 / 3.0-primeDefault output: 480P / 720P / 1080P
Upscale output: 2K / 4K
16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive2โ€“30 seconds; if there is a reference video, input+output must be 30 seconds or less

Input Conditions โ€‹

ItemCondition
Output frame rate30fps
Reference imageUp to 10 images
Reference videoUp to 5, 15 seconds in total
Reference audioUp 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 โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Wan
ModelVersionOptionalString3.0 / 3.0-prime / 2.2
PromptRequiredStringGeneration prompt
ImageUrlOptionalStringFirst frame image URL
LastImageUrlOptionalStringLast frame image URL. Used together with ImageUrl
DurationOptionalIntegerGeneration length (seconds). Default value 5
ExtraParametersOptionalObjectResolution / AspectRatio
AdditionalParametersOptionalStringJSON string containing model-specific options. For the seed delivery format, see Additional settings
ExtraParameters.
EnablelnputComplianceCheck
OptionalBooleanIf false is explicitly passed, input moderation is released. Contact your sales representative before use
ExtraParameters.
EnableOutputComplianceCheck
OptionalBooleanIf false is explicitly passed, output moderation is released. Contact your sales representative before use

Request Example โ€‹

json
{
  "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 โ€‹

json
{
  "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.

ParameterRelease valueApplies to
ExtraParameters.EnablelnputComplianceCheckfalseInput moderation release
ExtraParameters.EnableOutputComplianceCheckfalseOutput moderation release

Merge the following settings into an existing generation request. To release both input and output moderation, pass both fields together.

json
{
  "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.

ModelVersionResolutionAspectRatioOutput resolution
3.01080P16:91920x1080
3.0-prime720P16:91280x720
2.2720P16:91280x704

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.

json
{
  "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/"
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages