How to Use Wan 2.2 Animate Replace in Gemini CLI
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 Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Wan 2.2 Animate Replace with the project's solo dance clip and character portrait to create a choreography preview.
Use Wan 2.2 Animate Replace to audition the project's three character portraits against the same actor clip.
Create a presenter preview with Wan 2.2 Animate Replace using the project's character image and solo host recording.
Use Wan 2.2 Animate Replace for the cutscene rehearsal. Select the project character image closest to the actor's proportions.
Use Wan 2.2 Animate Replace to create a 720p expression study from the project's actor footage and character portrait.
How to set up Wan 2.2 Animate Replace in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Gemini CLI 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.
Settings you can ask for
Wan 2.2 Animate Replace works from your video URL and image URL. Ask Gemini CLI for any of these in your prompt.
| 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, or 720p | 480p | Resolution of the generated video (480p, 580p, or 720p). |
| Seed | a whole number | Random seed for reproducibility. If None, a random seed is chosen. | |
| Number of 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, or maximum | high | The quality of the output video. Higher quality means better visual quality but larger file size. |
| Video write mode | fast, balanced, or small | balanced | 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 ZIP | on or off | off | If true, also return a ZIP archive containing per-frame images generated on GPU (lossless). |
| Use turbo | on or off | off | 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 Gemini CLI?
Turn recorded performances into character previews for a game's cutscene or a site's video assets. A coding agent can pair project references with footage and organize the results for review.
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.
More on Wan 2.2 Animate Replace and Gemini CLI
Overview
Wan 2.2 Animate Replace in other agents
Questions about Wan 2.2 Animate Replace in Gemini CLI
Can Gemini CLI use Wan 2.2 Animate Replace?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Wan 2.2 Animate Replace like any built-in tool.
How much does Wan 2.2 Animate Replace cost in Gemini CLI?
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 Gemini CLI plan is separate.
Do I need a fal account to use Wan 2.2 Animate Replace in Gemini CLI?
No. Spiral runs Wan 2.2 Animate Replace on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Wan 2.2 Animate Replace in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Wan 2.2 Animate Replace runs?
Wan 2.2 Animate Replace runs in the background. Gemini CLI 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.
Start using Wan 2.2 Animate Replace in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


