[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Wan 2.2 Animate Replace](https://spiral.ai/integrations/n8n/wan-2-2-animate-replace)

# How to Use Wan 2.2 Animate Replace in n8n

Wan 2.2 Animate Replace puts a reference character into an existing performance, carrying over movement and expressions. Unlike Wan 2.2 Animate, it keeps the video's scene rather than the character image's background.

|  |  |
| --- | --- |
| Model | Wan 2.2 Animate Replace |
| Available through | fal |
| Category | Video |
| Price | Up to $3.12 per run at the default inputs for 60 seconds of input. `resolution`: 480p (default) $3.12, 580p $4.68, 720p $6.24. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Wan 2.2 Animate Replace in n8n

- Each Monday, use Wan 2.2 Animate Replace to preview approved character portraits against the latest approved solo performance.
- Each morning, use Wan 2.2 Animate Replace for new approved presenter clips with the matching character image.
- Each Friday, use Wan 2.2 Animate Replace to make 720p previews from approved solo dance clips and character images.
- Weekly, use Wan 2.2 Animate Replace to audition two approved character portraits against one approved actor performance.
- Every Monday, use Wan 2.2 Animate Replace for approved expression studies and flag visible deformation for review.

## How to set up Wan 2.2 Animate Replace in n8n

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send n8n this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run Wan 2.2 Animate Replace in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Wan 2.2 Animate Replace, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Wan 2.2 Animate Replace**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/wan/v2.2-14b/animate/replace",
    "input": {
      "video_url": "https://v3b.fal.media/files/b/panda/a6SvJg96V8eoglMlYFShU_5385885-hd_1080_1920_25fps.mp4",
      "image_url": "https://v3b.fal.media/files/b/panda/-oMlZo9Yyj_Nzoza_tgds_GmLF86r5bOt50eMMKCszy_eacc949b3933443c9915a83c98fbe85e.png"
    }
  }'
```

Then paste one of the prompts above: n8n finds Wan 2.2 Animate Replace on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/n8n

## Wan 2.2 Animate Replace tools and prices

- [Wan-2.2 Animate Replace](https://spiral.ai/tools/fal/fal-ai/wan/v2.2-14b/animate/replace) (fal): `resolution`: 480p (default) $0.052, 580p $0.078, 720p $0.104 per second.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 1 to 10 | 1 | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. |
| resolution | 480p, 580p, 720p | 480p | Resolution of the generated video (480p, 580p, or 720p). |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |
| num_inference_steps | 2 to 40 | 20 | Number of inference steps for sampling. Higher values give better quality but take longer. |
| shift | 1 to 10 | 5 | Shift value for the video. Must be between 1.0 and 10.0. |
| video_quality | low, medium, high, maximum | high | The quality of the output video. Higher quality means better visual quality but larger file size. |

## What can you do with Wan 2.2 Animate Replace in n8n?

Create recurring character auditions from newly approved performance clips. A scheduled agent can prepare previews and flag results that need a person to check body shape or scene integration.

### Dance character tests

Replace a solo dancer with a reference character to test how the choreography reads with a different appearance.

### Film character previews

Use a recorded performance and character artwork to preview a casting or character-design choice in the existing scene.

### Digital presenter clips

Transfer a solo presenter's gestures and expressions to a reference character while retaining the recorded setting.

### Advertising character auditions

Try several character images against one recorded performance to compare appearance in the same scene.

### Game character performance studies

Preview a character design using an actor's recorded movement. Favor similar body proportions when assessing the result.

### Expression studies

Use a solo actor's expressive performance to explore how a reference character conveys the same reactions.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## Wan 2.2 Animate Replace in other agents

- [Amp](https://spiral.ai/integrations/amp/wan-2-2-animate-replace)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/wan-2-2-animate-replace)
- [Claude](https://spiral.ai/integrations/claude-desktop/wan-2-2-animate-replace)
- [Claude Code](https://spiral.ai/integrations/claude-code/wan-2-2-animate-replace)
- [Cline](https://spiral.ai/integrations/cline/wan-2-2-animate-replace)
- [Codex](https://spiral.ai/integrations/codex/wan-2-2-animate-replace)
- [Cursor](https://spiral.ai/integrations/cursor/wan-2-2-animate-replace)
- [Devin](https://spiral.ai/integrations/devin/wan-2-2-animate-replace)
- [dots](https://spiral.ai/integrations/dots/wan-2-2-animate-replace)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/wan-2-2-animate-replace)
- [Gemini](https://spiral.ai/integrations/gemini/wan-2-2-animate-replace)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/wan-2-2-animate-replace)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/wan-2-2-animate-replace)
- [goose](https://spiral.ai/integrations/goose/wan-2-2-animate-replace)
- [Grok](https://spiral.ai/integrations/grok/wan-2-2-animate-replace)
- [Grok Build](https://spiral.ai/integrations/grok-build/wan-2-2-animate-replace)
- [Hermes](https://spiral.ai/integrations/hermes/wan-2-2-animate-replace)
- [Instinct](https://spiral.ai/integrations/instinct/wan-2-2-animate-replace)
- [Manus](https://spiral.ai/integrations/manus/wan-2-2-animate-replace)
- [Muse](https://spiral.ai/integrations/muse/wan-2-2-animate-replace)
- [Muse Code](https://spiral.ai/integrations/muse-code/wan-2-2-animate-replace)
- [Notion](https://spiral.ai/integrations/notion/wan-2-2-animate-replace)
- [OpenClaw](https://spiral.ai/integrations/openclaw/wan-2-2-animate-replace)
- [opencode](https://spiral.ai/integrations/opencode/wan-2-2-animate-replace)
- [Perplexity](https://spiral.ai/integrations/perplexity/wan-2-2-animate-replace)
- [Raycast](https://spiral.ai/integrations/raycast/wan-2-2-animate-replace)
- [VS Code](https://spiral.ai/integrations/vscode/wan-2-2-animate-replace)
- [Windsurf](https://spiral.ai/integrations/windsurf/wan-2-2-animate-replace)
- [Zapier](https://spiral.ai/integrations/zapier/wan-2-2-animate-replace)

## More n8n guides

- [Wan 2.2 Animate Move](https://spiral.ai/integrations/n8n/wan-2-2-animate-move)
- [Wan 2.2 FastWan 5B Text to Video](https://spiral.ai/integrations/n8n/wan-2-2-fastwan-5b-text-to-video)
- [Wan 2.2 A14B Video to Video](https://spiral.ai/integrations/n8n/wan-2-2-a14b-video-to-video)
- [Wan 2.2 S2V 14B](https://spiral.ai/integrations/n8n/wan-2-2-s2v-14b)
- [Wan 2.2 A14B Text to Video Turbo](https://spiral.ai/integrations/n8n/wan-2-2-a14b-text-to-video-turbo)
- [Wan 2.5 Image to Video](https://spiral.ai/integrations/n8n/wan-2-5-image-to-video)

## Questions about Wan 2.2 Animate Replace in n8n

**Can n8n use Wan 2.2 Animate Replace?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run Wan 2.2 Animate Replace like any built-in tool.

**How much does Wan 2.2 Animate Replace cost in n8n?**

Up to $3.12 per run at the default inputs for 60 seconds of input. `resolution`: 480p (default) $3.12, 580p $4.68, 720p $6.24. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

**Do I need a fal account to use Wan 2.2 Animate Replace in n8n?**

You need no fal account. n8n uses one Spiral API key for every tool, and Spiral runs Wan 2.2 Animate Replace on its own fal account.

**How long does it take to set up Wan 2.2 Animate Replace in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while Wan 2.2 Animate Replace runs?**

Wan 2.2 Animate Replace runs in the background. n8n starts the run, checks on it and gives you the video when it's ready.

**What does Wan 2.2 Animate Replace keep from the original video?**

It retains the scene and uses the recorded movement and expressions to drive the replacement character. It also aims to match the scene's lighting and color tone.

**How does Replace differ from Wan 2.2 Animate?**

Replace uses the performance video's background. Wan 2.2 Animate uses the character image's background.

**Can Wan 2.2 Animate Replace handle several people?**

Choose footage with one person. The maker's supplied mask extraction can track the wrong person or fail when several people appear.

**Why does the replacement character look distorted?**

A large mismatch between the performer's proportions and the reference character can cause deformation. Try a character with a closer build before changing other settings.

**Can a detailed prompt change the recorded action?**

The recorded motion is the main control. Choose footage that already contains the action you want; the served implementation generates its own model prompt.

