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

falVideoAvailable nowReleased 2025-09-19

Wan-2.2 Animate Replace

fal-ai/wan/v2.2-14b/animate/replace

Edit and transform video with Wan-2.2 Animate Replace from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

resolution: 480p (default) $0.052, 580p $0.078, 720p $0.104 per second.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
video_url requiredURL or file—

URL of the input video.

image_url requiredURL or file—

URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped.

guidance_scalenumber
1 to 10
1

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

resolutionone of
480p, 580p, 720p
480p

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

seednumber (whole)—

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

num_inference_stepsnumber (whole)
2 to 40
20

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

shiftnumber
1 to 10
5

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

video_qualityone of
low, medium, high, maximum
high

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

video_write_modeone of
fast, balanced, 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_ziptrue or falsefalse

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

use_turbotrue or falsefalse

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

Same request in code

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"
    }
  }'

Frequently asked questions

How much does Wan-2.2 Animate Replace cost?

`resolution`: 480p (default) $0.052, 580p $0.078, 720p $0.104 per second. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Wan-2.2 Animate Replace through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/wan/v2.2-14b/animate/replace"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Wan-2.2 Animate Replace?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Wan-2.2 Animate Replace?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.