---
title: Wan2.2 Animate | Runware Docs
url: https://runware.ai/docs/models/alibaba-wan2-2-animate
description: AI character animation and replacement video generation
---
# Wan2.2 Animate

Wan2.2 Animate is a unified video model that produces character-focused animations from static images and reference videos or replaces characters in existing footage while preserving motion, expressions, and scene consistency. It uses the Wan2.2 mixture-of-experts architecture to generate coherent character movement and seamless integration with background video.

- **ID**: `runware:200@8`
- **Status**: api-only
- **Creator**: Alibaba
- **Release Date**: September 19, 2025
- **Capabilities**: Image to Video, Video to Video

## Pricing

- **480p · 1s**: `$0.010`
- **580p · 1s**: `$0.014`
- **720p · 1s**: `$0.0212`

## Compatibility & Validation

Either provide `inputs.referenceImages` or `inputs.referenceVideos`, or specify `width/height` or `resolution`.

---

`resolution` cannot be used with `width/height`.

---

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `360p (1:1)` | `480x480` |
| `360p (15:22)` | `480x704` |
| `360p (22:15)` | `704x480` |
| `360p (9:16)` | `480x832` |
| `360p (16:9)` | `832x480` |
| `720p (3:8)` | `480x1280` |
| `720p (8:3)` | `1280x480` |
| `720p (1:1)` | `704x704` |
| `720p (11:13)` | `704x832` |
| `720p (13:11)` | `832x704` |
| `720p (9:16)` | `704x1280` |
| `720p (16:9)` | `1280x704` |
| `720p (1:1)` | `832x832` |
| `720p (13:20)` | `832x1280` |
| `720p (20:13)` | `1280x832` |
| `1080p (1:1)` | `1280x1280` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Identifier for the type of task being performed

### [taskUUID](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-outputformat)

- **Type**: `string`
- **Default**: `MP4`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`MP4\`: Widely supported video container (H.264), recommended for general use.
- \`WEBM\`: Optimized for web delivery.
- \`MOV\`: QuickTime format, common in professional workflows (Apple ecosystem).

**Allowed values**: `MP4` `WEBM` `MOV`

### [outputQuality](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-webhookurl)

- **Type**: `string`
- **Format**: `URI`

Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/platform/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-deliverymethod)

- **Type**: `string`
- **Default**: `async`

Determines how the API delivers task results.

**Allowed values**:

- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. Required for long-running tasks like video generation.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/platform/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-uploadendpoint)

- **Type**: `string`
- **Format**: `URI`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (2 properties)`

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`
- **Default**: `false`

Enable or disable content safety checking. When enabled, defaults to `fast` mode.

#### [mode](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-safety-mode)

- **Path**: `safety.mode`
- **Type**: `string`
- **Default**: `none`

Safety checking mode for video generation.

**Allowed values**:

- `none` Disables checking.
- `fast` Checks key frames.
- `full` Checks all frames.

### [ttl](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-includecost)

- **Type**: `boolean`
- **Default**: `false`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

### [acceleratorOptions](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions)

- **Path**: `acceleratorOptions.cacheEndStep`
- **Type**: `object (12 properties)`

Advanced caching mechanisms to speed up generation.

#### [cacheEndStep](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-cacheendstep)

- **Path**: `acceleratorOptions.cacheEndStep`
- **Type**: `integer`
- **Min**: `1`

Absolute step number to end caching. Must be greater than `cacheStartStep` and less than or equal to `steps`.

#### [cacheEndStepPercentage](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-cacheendsteppercentage)

- **Path**: `acceleratorOptions.cacheEndStepPercentage`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `100`

Percentage of steps to end caching. Alternative to `cacheEndStep`. Must be greater than `cacheStartStepPercentage`.

#### [cacheMaxConsecutiveSteps](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-cachemaxconsecutivesteps)

- **Path**: `acceleratorOptions.cacheMaxConsecutiveSteps`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `5`
- **Default**: `3`

Limits the maximum number of consecutive steps that can use cached computations before forcing a fresh computation.

#### [cacheStartStep](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-cachestartstep)

- **Path**: `acceleratorOptions.cacheStartStep`
- **Type**: `integer`
- **Min**: `0`

Absolute step number to start caching. Must be less than `cacheEndStep`.

#### [cacheStartStepPercentage](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-cachestartsteppercentage)

- **Path**: `acceleratorOptions.cacheStartStepPercentage`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `99`

Percentage of steps to start caching. Alternative to `cacheStartStep`. Must be less than `cacheEndStepPercentage`.

#### [fbCache](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-fbcache)

- **Path**: `acceleratorOptions.fbCache`
- **Type**: `boolean`
- **Default**: `false`

First Block Cache (FBCache) acceleration. Reuses feature block computations across steps.

#### [fbCacheThreshold](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-fbcachethreshold)

- **Path**: `acceleratorOptions.fbCacheThreshold`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.25`

Controls the sensitivity threshold for determining when to reuse cached computations. Lower values reuse more aggressively.

#### [teaCache](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-teacache)

- **Path**: `acceleratorOptions.teaCache`
- **Type**: `boolean`
- **Default**: `false`

TeaCache acceleration for transformer-based models. Estimates step differences to skip redundant computations.

#### [teaCacheDistance](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-teacachedistance)

- **Path**: `acceleratorOptions.teaCacheDistance`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.5`

Controls the aggressiveness of the TeaCache feature. Lower values prioritize quality, higher values prioritize speed.

#### [dbCache](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-dbcache)

- **Path**: `acceleratorOptions.dbCache`
- **Type**: `boolean`
- **Default**: `false`

DB Cache (CacheDiT) acceleration. Caches and reuses intermediate transformer block outputs to skip redundant computations.

#### [dbCacheThreshold](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-dbcachethreshold)

- **Path**: `acceleratorOptions.dbCacheThreshold`
- **Type**: `float`
- **Min**: `0`
- **Max**: `1`
- **Step**: `0.01`
- **Default**: `0.25`

Controls the sensitivity threshold for DB Cache. Lower values reuse cached blocks more aggressively, higher values prioritize quality.

#### [dbCacheSkipInterval](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-acceleratoroptions-dbcacheskipinterval)

- **Path**: `acceleratorOptions.dbCacheSkipInterval`
- **Type**: `integer`
- **Min**: `1`
- **Default**: `5`

Controls how many steps to skip between cache refreshes. Higher values skip more steps for faster generation at the cost of quality.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Required**: true

List of reference images (UUID, URL, Data URI, or Base64).

### [referenceVideos](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-inputs-referencevideos)

- **Path**: `inputs.referenceVideos`
- **Type**: `array of strings`
- **Required**: true

List of reference videos (UUID, URL).

**Generation Parameters**

Core parameters for controlling the generated content.

### [model](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `runware:200@8`

Identifier of the model to use for generation.

**Learn more** (3 resources):

- [Text To Image: Model Selection The Foundation Of Generation](https://runware.ai/docs/guides/text-to-image#model-selection-the-foundation-of-generation) (guide)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/guides/image-inpainting#model-specialized-inpainting-models) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [positivePrompt](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-positiveprompt)

- **Type**: `string`
- **Min**: `1`
- **Max**: `2000`
- **Default**: `视频中的人在做动作`

Text prompt describing elements to include in the generated output.

**Learn more** (2 resources):

- [Text To Image: Prompts Guiding The Generation](https://runware.ai/docs/guides/text-to-image#prompts-guiding-the-generation) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [negativePrompt](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-negativeprompt)

- **Type**: `string`
- **Min**: `1`
- **Max**: `2000`

Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).

**Learn more** (1 resource):

- [Text To Image: Prompts Guiding The Generation](https://runware.ai/docs/guides/text-to-image#prompts-guiding-the-generation) (guide)

### [width](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-width)

- **Type**: `integer`
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [height](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-height)

- **Type**: `integer`
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [resolution](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-resolution)

- **Type**: `string`

Resolution preset for the output. When used with input media, automatically matches the aspect ratio from the input.

**Allowed values**: `480p` `580p` `720p`

### [fps](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-fps)

- **Type**: `integer`
- **Min**: `4`
- **Max**: `60`
- **Default**: `16`

Frames per second for video generation. Higher values create smoother motion but require more processing time.

### [seed](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `9223372036854776000`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Text To Image: Seed Controlling Randomness Deterministically](https://runware.ai/docs/guides/text-to-image#seed-controlling-randomness-deterministically) (guide)

### [steps](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-steps)

- **Type**: `integer`
- **Min**: `2`
- **Max**: `50`
- **Default**: `30`

Total number of denoising steps. Higher values generally produce more detailed results but take longer.

**Learn more** (1 resource):

- [Text To Image: Steps Trading Quality For Speed](https://runware.ai/docs/guides/text-to-image#steps-trading-quality-for-speed) (guide)

### [scheduler](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-scheduler)

- **Type**: `string`

Scheduler to use for the diffusion process.

**Allowed values**: `DDIM` `DDIMScheduler` `DDPMScheduler` `DEISMultistepScheduler` `Default` `DPM++` `DPM++ 2M` `DPM++ 2M Beta` `DPM++ 2M Exponential` `DPM++ 2M Karras` `DPM++ 2M SDE` `DPM++ 2M SDE Beta` `DPM++ 2M SDE Exponential` `DPM++ 2M SDE Karras` `DPM++ 2M SDE Uniform` `DPM++ 2M Uniform` `DPM++ 3M` `DPM++ 3M Beta` `DPM++ 3M Exponential` `DPM++ 3M Karras` `DPM++ 3M SDE Uniform` `DPM++ 3M Uniform` `DPM++ Beta` `DPM++ Exponential` `DPM++ Karras` `DPM++ SDE` `DPM++ SDE Beta` `DPM++ SDE Exponential` `DPM++ SDE Karras` `DPM++ Uniform` `DPM++ Uniform Beta` `DPM++ Uniform Exponential` `DPM++ Uniform Karras` `DPMSolverMultistepInverse` `DPMSolverMultistepScheduler` `DPMSolverSinglestepScheduler` `EDMDPMSolverMultistepScheduler` `EDMEulerScheduler` `Euler` `Euler a` `Euler Beta` `Euler DiscreteScheduler` `Euler Exponential` `Euler Karras` `EulerAncestralDiscreteScheduler` `FlowMatchEulerDiscreteScheduler` `Heun` `HeunDiscreteScheduler` `Heun Karras` `IPNDMScheduler` `IPNDM Uniform` `IPNDM Uniform Beta` `IPNDM Uniform Exponential` `IPNDM Uniform Karras` `KDPM2AncestralDiscreteScheduler` `KDPM2DiscreteScheduler` `LCM` `LCMScheduler` `LMS` `LMSDiscreteScheduler` `LMS Karras` `PNDMScheduler` `TCDScheduler` `UniPC` `UniPC 2M` `UniPC 2M Karras` `UniPC 2M Uniform` `UniPC 3M` `UniPC 3M Karras` `UniPC 3M Uniform` `UniPC Karras` `UniPC Uniform` `UniPC Uniform Beta` `UniPC Uniform Exponential` `UniPC Uniform Karras`

**Learn more** (2 resources):

- [Text To Image: Scheduler The Algorithmic Path To Your Image](https://runware.ai/docs/guides/text-to-image#scheduler-the-algorithmic-path-to-your-image) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [CFGScale](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-cfgscale)

- **Type**: `float`
- **Min**: `0`
- **Step**: `0.01`

Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.

**Learn more** (1 resource):

- [Text To Image: Cfg Scale Balancing Creativity And Control](https://runware.ai/docs/guides/text-to-image#cfg-scale-balancing-creativity-and-control) (guide)

### [lora](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-lora)

- **Path**: `lora.model`
- **Type**: `array of objects (3 properties)`

With LoRA (Low-Rank Adaptation), you can adapt a model to specific styles or features by emphasizing particular aspects of the data. This technique enhances the quality and relevance of generated content and can be especially useful when the output needs to adhere to a specific artistic style or follow particular guidelines.

Multiple LoRA models can be used simultaneously to achieve different adaptation goals.

**Examples**:

```json
"lora": [
  {
    "model": "<lora-model-air>",
    "weight": 0.8
  }
]
```

**Learn more** (1 resource):

- [Text To Image: Loras Style And Subject Adapters](https://runware.ai/docs/guides/text-to-image#loras-style-and-subject-adapters) (guide)

#### [model](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-lora-model)

- **Path**: `lora.model`
- **Type**: `string`
- **Required**: true

LoRA model identifier.

#### [weight](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-lora-weight)

- **Path**: `lora.weight`
- **Type**: `float`
- **Min**: `-4`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

Strength of the LoRA influence. A value of 0 means no influence. Higher values increase the influence, and negative values can be used to steer away from the LoRA's style.

#### [transformer](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-lora-transformer)

- **Path**: `lora.transformer`
- **Type**: `string`
- **Default**: `both`

Transformer stages to apply LoRA. Some video models use separate high-noise and low-noise processing stages, and LoRAs can be selectively applied to optimize their effectiveness.

**Allowed values**:

- `high` Apply LoRA only to the high-noise processing stage (coarse structure and early generation steps).
- `low` Apply LoRA only to the low-noise processing stage (fine details and later generation steps).
- `both` Apply LoRA to both stages for full coverage.

**Features**

Standalone addons and post-processing features.

### [wanAnimate](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-advancedfeatures-wananimate)

- **Path**: `advancedFeatures.wanAnimate`
- **Type**: `object (3 properties)`

Wan Animate model settings.

#### [mode](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-advancedfeatures-wananimate-mode)

- **Path**: `advancedFeatures.wanAnimate.mode`
- **Type**: `string`
- **Default**: `animate`

Animation strategy. `animate` uses pose detection and retargeting (ideal for bringing characters to life). `replace` uses segmentation to substitute characters in existing footage.

**Allowed values**: `animate` `replace`

#### [prevSegCondFrames](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-advancedfeatures-wananimate-prevsegcondframes)

- **Path**: `advancedFeatures.wanAnimate.prevSegCondFrames`
- **Type**: `integer`
- **Min**: `1`
- **Max**: `5`
- **Default**: `1`

Number of frames from previous segment for temporal consistency. Higher values improve continuity but increase inference time.

#### [retargetPose](https://runware.ai/docs/models/alibaba-wan2-2-animate#request-advancedfeatures-wananimate-retargetpose)

- **Path**: `advancedFeatures.wanAnimate.retargetPose`
- **Type**: `boolean`
- **Default**: `false`

Retarget pose to match reference image. Only supported in `animate` mode.

## Response Parameters

### [taskType](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Type of the task.

### [taskUUID](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the task.

### [videoUUID](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-videouuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-videourl)

- **Type**: `string`
- **Format**: `URI`

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-videodatauri)

- **Type**: `string`
- **Format**: `URI`

Data URI of the output video.

### [seed](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/alibaba-wan2-2-animate#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.