# Wan-2.2 Animate Replace > Wan-Animate Replace is a model that can integrate animated characters into reference videos, replacing the original character while preserving the scene’s lighting and color tone for seamless environmental integration. ## Overview - **Endpoint**: `https://fal.run/fal-ai/wan/v2.2-14b/animate/replace` - **Model ID**: `fal-ai/wan/v2.2-14b/animate/replace` - **Category**: video-to-video - **Kind**: inference **Tags**: video to video, motion ## Pricing Your request will cost **$0.08** per **video second** for **720p**, **$0.06** per **video second** for **580p**, **$0.04** per **video second** for **480p**. Video seconds are calculated at 16 frames per second. For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`video_url`** (`string`, _required_): URL of the input video. - Examples: "https://v3b.fal.media/files/b/panda/a6SvJg96V8eoglMlYFShU_5385885-hd_1080_1920_25fps.mp4" - **`image_url`** (`string`, _required_): URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. - Examples: "https://v3b.fal.media/files/b/panda/-oMlZo9Yyj_Nzoza_tgds_GmLF86r5bOt50eMMKCszy_eacc949b3933443c9915a83c98fbe85e.png" - **`guidance_scale`** (`float`, _optional_): Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. Default value: `1` - Default: `1` - Range: `1` to `10` - Examples: 1 - **`resolution`** (`ResolutionEnum`, _optional_): Resolution of the generated video (480p, 580p, or 720p). Default value: `"480p"` - Default: `"480p"` - Options: `"480p"`, `"580p"`, `"720p"` - Examples: "480p" - **`seed`** (`integer`, _optional_): Random seed for reproducibility. If None, a random seed is chosen. - **`num_inference_steps`** (`integer`, _optional_): Number of inference steps for sampling. Higher values give better quality but take longer. Default value: `20` - Default: `20` - Range: `2` to `40` - Examples: 6 - **`enable_safety_checker`** (`boolean`, _optional_): If set to true, input data will be checked for safety before processing. - Default: `false` - Examples: true - **`enable_output_safety_checker`** (`boolean`, _optional_): If set to true, output video will be checked for safety after generation. - Default: `false` - Examples: false - **`shift`** (`float`, _optional_): Shift value for the video. Must be between 1.0 and 10.0. Default value: `5` - Default: `5` - Range: `1` to `10` - Examples: 8 - **`video_quality`** (`VideoQualityEnum`, _optional_): The quality of the output video. Higher quality means better visual quality but larger file size. Default value: `"high"` - Default: `"high"` - Options: `"low"`, `"medium"`, `"high"`, `"maximum"` - Examples: "high" - **`video_write_mode`** (`VideoWriteModeEnum`, _optional_): 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. Default value: `"balanced"` - Default: `"balanced"` - Options: `"fast"`, `"balanced"`, `"small"` - Examples: "balanced" - **`return_frames_zip`** (`boolean`, _optional_): If true, also return a ZIP archive containing per-frame images generated on GPU (lossless). - Default: `false` - **`use_turbo`** (`boolean`, _optional_): If true, applies quality enhancement for faster generation with improved quality. When enabled, parameters are automatically optimized for best results. - Default: `false` - Examples: true **Required Parameters Example**: ```json { "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" } ``` **Full Example**: ```json { "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", "guidance_scale": 1, "resolution": "480p", "num_inference_steps": 6, "enable_safety_checker": true, "enable_output_safety_checker": false, "shift": 8, "video_quality": "high", "video_write_mode": "balanced", "use_turbo": true } ``` ### Output Schema The API returns the following output format: - **`video`** (`File`, _required_): The generated video file. - Examples: {"url":"https://v3b.fal.media/files/b/elephant/9Ofgiju3Peb3b5hriTuBH_wan_animate_output.mp4"} - **`frames_zip`** (`File`, _optional_): ZIP archive of generated frames (if requested). - **`prompt`** (`string`, _required_): The prompt used for generation (auto-generated by the model) - Examples: "" - **`seed`** (`integer`, _required_): The seed used for generation - Examples: 1416721728 **Example Response**: ```json { "video": { "url": "https://v3b.fal.media/files/b/elephant/9Ofgiju3Peb3b5hriTuBH_wan_animate_output.mp4" }, "prompt": "", "seed": 1416721728 } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/wan/v2.2-14b/animate/replace \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "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" }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/wan/v2.2-14b/animate/replace", arguments={ "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" }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("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" }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/wan/v2.2-14b/animate/replace) - [API Documentation](https://fal.ai/models/fal-ai/wan/v2.2-14b/animate/replace/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/wan/v2.2-14b/animate/replace) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)