Wan 2.1 VACE Inpainting

Name: Alibaba Wan 2.1 VACE Inpainting
Price: 0.2 USD
Availability: InStock
Author: Alibaba

alibaba/wan/2.1/vace/inpainting

Wan 2.1 Vace is Alibaba's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.

Use in agent Get API key

Base price: $0.20USD / run
Execution: async
Model type: video
Input fields: 6

Try the model

Playground

Open playground

Input

Prompt(string)

The text prompt to guide video generation.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Mask Image URL(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL to the guiding mask file. If provided, the model will use this mask as a reference to create masked video using salient mask tracking. Will be ignored if mask_video_url is provided.

Video URL(string)

URL to the source video file. Required for inpainting.

Resolution(string)

Resolution of the generated video. Allowed values: auto, 240p, 360p, 480p, 720p.

Seed(integer)

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

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.20 / run

Context & modalities

Input: Schema-defined
Output: video

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Alibaba
Model ID: alibaba/wan/2.1/vace/inpainting
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Wan 2.1 VACE Inpainting

Wan 2.1 VACE Inpainting is a Wan-family route for masked video inpainting. Wan’s video-focused generative architecture models appearance and time together, so supplied references, structural conditions, masks, speech, or written scene direction can influence a coherent sequence rather than a collection of unrelated frames. This exact route concentrates that architecture on its named production task.

Use the route when the available source material and final brief specifically require masked video inpainting. Identify every subject or condition, explain the intended action or transformation, and describe camera behavior, pacing, environment, lighting, atmosphere, and preservation constraints. This separates creative intent from the local duration, resolution, and delivery fields documented below.

Highlights

Temporal hole filling. Reconstructs masked video regions coherently across time.
Motion-aware boundary blending. Matches movement, texture, perspective, and illumination around the edited area.
Prompt-directed replacement. Introduces requested content inside the mask while respecting the source clip.
Unmasked-region preservation. Keeps areas outside the edit mask connected to the original sequence.

Pricing

Resolution	Billing unit	Price
auto	Per generated second	$0.040
240p	Per generated second	$0.040
360p	Per generated second	$0.040
480p	Per generated second	$0.040
720p	Per generated second	$0.080

When to Use

✅ Good fit	❌ Consider alternatives
The project needs this exact named workflow	The intended task belongs to another media route
All required reference or control media is available	Necessary assets or rights are unavailable
The brief can state transformation and preservation goals	Output must be deterministic at pixel or frame level
Supported duration, resolution, and format fit delivery	Final placement requires unsupported specifications
An asynchronous generated result fits production	A live frame-synchronous response is mandatory

Prompt Guide

Identify the primary subject and every source or condition, state the intended transformation or action, then describe composition, camera or viewpoint, lighting, materials, pacing, atmosphere, and exact preservation requirements. Refer to multiple inputs in their schema order.

{
  "prompt": "A precisely directed composition with explicit subject, transformation, camera or viewpoint, lighting, material, and preservation requirements",
  "mask": "https://example.com/reference.png",
  "seed": 1,
  "video": "https://example.com/source.mp4"
}

Technical Specs

Spec	Value
Model ID	`alibaba/wan/2.1/vace/inpainting`
Input fields	`mask` (string)<br>`seed` (integer)<br>`video` (string)<br>`prompt` (string)<br>`resolution` (string; `auto`, `240p`, `360p`, `480p`, `720p`)<br>`aspect_ratio` (string; `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`)
Required input	`prompt`
Output fields	`url`, `content_type`
Execution	Asynchronous job

Related Models

alibaba/wan/2.1/text-to-video
alibaba/wan/2.1/image-to-video
alibaba/wan/2.1/vace

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

alibaba/wan/2.1/vace/inpainting

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "alibaba/wan/2.1/vace/inpainting",
  "video": "https://static.sandbase.ai/examples/alibaba/wan/2.1/vace/inpainting/input_video_1.mp4",
  "prompt": "The video shows a man riding a horse on a vast grassland. He has long lavender hair and wears a traditional dress of a white top and black pants. The animation style makes him look like he is doing some kind of outdoor activity or performing. The background is a spectacular mountain range and cloud sky, giving a sense of tranquility and vastness. The entire video is shot from a fixed angle, focusing on the rider and his horse.",
  "resolution": "auto"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
Wan 2.1 VACE InpaintingThis model `Alibaba`	Video	$0.20 / run	Jun 18, 2025
Wan 3.0 Prime Video Edit `Alibaba`	Video	$1.40 / run	Oct 4, 2026
Wan 3.0 Prime Video Extend `Alibaba`	Video	$2.80 / run	Oct 4, 2026
Wan 3.0 Video Edit `Alibaba`	Video	$1.00 / run	Oct 4, 2026
Wan 3.0 Video Extend `Alibaba`	Video	$2.00 / run	Oct 4, 2026
Wan 3.0 Prime Text to Video `Alibaba`	Video	$0.70 / run	Aug 24, 2026

Questions

FAQ

How do I call Alibaba Wan 2.1 VACE Inpainting through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/wan/2.1/vace/inpainting" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Alibaba account?

No. One SandBase API key and balance gives you access to Alibaba Wan 2.1 VACE Inpainting and the other models in the catalog; you do not need to sign up with Alibaba separately.