Wan 2.2 Animate
Playground
Try it on WavespeedAI!Wan2.2-Animate is a unified model for character animation and replacement with holistic movement and expression replication. The model is released under the Apache 2.0 license and supports commercial use. Our endpoint starts with $0.2 per 5 seconds (480p) or $0.4 per 5 seconds (720p) video generation and supports a maximum generation length of 120 seconds.
Features
Wan2.2-Animate
What is Wan2.2-Animate?
Wan2.2-Animate is a unified model for character animation and replacement with holistic movement and expression replication.
Pricing
Our endpoint starts with $0.2 per 5 seconds (480p) or $0.4 per 5 seconds (720p) video generation and supports a maximum generation length of 120 seconds.
Tips
The composition style, as well as the camera position and human body pose of the reference image and the video should be as consistent as possible; otherwise, the probability of generation failure will increase significantly.
The aspect ratio of the input image and video should be the same to achieve the best output.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/wan-2.2/animate" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"mode": "animate",
"resolution": "480p",
"seed": -1
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | - | The image for generating the output. | |
| video | string | Yes | - | The video for generating the output. | |
| prompt | string | No | - | The prompt for generating the output. | |
| mode | string | No | animate | animate, replace | The mode of the generation. Animate Mode: animate the character in input image with movements from the input video. Replace Mode: replace the character in input video with the character in input image. |
| resolution | string | No | 480p | 480p, 720p | The resolution of the output video. |
| seed | integer | No | -1 | -1 ~ 2147483647 | The random seed to use for the generation. -1 means a random seed will be used. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |