Spiral gives your agent every tool with one account. Browse the tools →

Muse · VideoReleased 2025-09-19

How to Use Wan 2.2 Animate Replace in Muse

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.

Prompts to try with Wan 2.2 Animate Replace in Muse

Copy an example into Muse, or ask in your own words.

Use Wan 2.2 Animate Replace with this solo dance video and character image to preview the choreography.

Wan 2.2 Animate ReplaceMuse
Try asking
  • Use Wan 2.2 Animate Replace to put this character into my presenter recording, keeping the recorded scene.

  • Compare these two character images using Wan 2.2 Animate Replace with the same solo actor performance.

  • Make a 720p character preview with Wan 2.2 Animate Replace from this performance video and reference portrait.

  • Use Wan 2.2 Animate Replace for this expression study. Choose the supplied character image with proportions closest to the performer.

How to set up Wan 2.2 Animate Replace in Muse

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

Use the Muse connector

  1. Create an API key

    Create one under API keys in the Spiral console.

  2. Send Muse this message

    Muse reads Spiral's skill and asks for an API key.

    set up https://spiral.ai/SKILL.md
  3. Give Muse the key

    Paste the key when Muse asks for it, never in the chat itself.

Use the Spiral skill

  1. Send Muse 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 the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    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.

    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: Muse finds Wan 2.2 Animate Replace on Spiral, shows the price and runs it.

Wan 2.2 Animate Replace providers and prices

Spiral runs Wan 2.2 Animate Replace through fal. Open a card for today's price, with every fee included.

falVideo
Wan-2.2 Animate Replace
fal-ai/wan/v2.2-14b/animate/replace

Settings you can ask for

Wan 2.2 Animate Replace works from your video URL and image URL. Ask Muse for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Guidance scale1 to 101

Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality.

Resolution480p, 580p, or 720p480p

Resolution of the generated video (480p, 580p, or 720p).

Seeda whole number

Random seed for reproducibility. If None, a random seed is chosen.

Number of inference steps2 to 4020

Number of inference steps for sampling. Higher values give better quality but take longer.

Shift1 to 105

Shift value for the video. Must be between 1.0 and 10.0.

Video qualitylow, medium, high, or maximumhigh

The quality of the output video. Higher quality means better visual quality but larger file size.

Video write modefast, balanced, or smallbalanced

The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between speed and quality, and small write mode is the slowest but produces the smallest file size.

Return frames ZIPon or offoff

If true, also return a ZIP archive containing per-frame images generated on GPU (lossless).

Use turboon or offoff

If true, applies quality enhancement for faster generation with improved quality. When enabled, parameters are automatically optimized for best results.

Every API field of Wan-2.2 Animate Replace is on its tool page: open its card above.

What can you do with Wan 2.2 Animate Replace in Muse?

Preview a character performing recorded gestures, expressions, or choreography inside the original scene. A chat app can help select a suitable reference pair and explain what to inspect in the result.

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.

Questions about Wan 2.2 Animate Replace in Muse

Can Muse use Wan 2.2 Animate Replace?

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

How much does Wan 2.2 Animate Replace cost in Muse?

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 Muse plan is separate.

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

You need no fal account. Muse 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 Muse?

About two minutes: create an API key, then send Muse this message, then give Muse the key.

Does Muse wait while Wan 2.2 Animate Replace runs?

Wan 2.2 Animate Replace runs in the background. Muse 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.

Get started

Start using Wan 2.2 Animate Replace in Muse

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Muse:

Set up Muse

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options