Wan 2.1 VACE

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

alibaba/wan/2.1/vace

Wan 2.1 Vace by Alibaba - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.

Use in agent Get API key

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

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. If provided mask video url will be ignored.

Video URL(string)

URL to the source video file. If provided, the model will use this video as a reference.

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.

Task(string)

Task type for the model. Allowed values: depth, pose, inpainting, outpainting, reframe.

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
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Wan 2.1 VACE

Wan 2.1 VACE is the Wan 2.1 workflow for unified conditioned video. It models visual appearance and time together so the route’s written direction, source imagery, speech, masks, or structural conditions influence one coherent result rather than a collection of disconnected frames or a generic endpoint response.

Choose this exact route when the available assets and deliverable specifically call for unified conditioned video. Identify every subject and source, state the desired action or transformation, then describe camera behavior, pacing, environment, lighting, atmosphere, and preservation requirements; local schema fields handle resolution, duration, seed, and delivery separately from the creative brief.

Highlights

2.1 Composable video conditions. Combines reference, mask, structural, and written guidance.
2.1 Unified generation and editing. Supports creation and revision tasks through one temporal framework.
2.1 Cross-frame consistency. Maintains conditions and visual logic over time.
2.1 Reference-aware synthesis. Preserves specified subjects, geometry, or regions while generating new content.

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,
  "task": "depth"
}

Technical Specs

Spec	Value
Model ID	`alibaba/wan/2.1/vace`
Input fields	`mask` (string)<br>`seed` (integer)<br>`task` (string; `depth`, `pose`, `inpainting`, `outpainting`, `reframe`)<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.2/text-to-video

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

# 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",
  "task": "depth",
  "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 VACEThis model `Alibaba`	Video	$0.20 / run	May 27, 2025
Wan 3.0 Prime Video Edit `Alibaba`	Video	$1.40 / run	Oct 4, 2026
Wan 3.0 Prime Video Extend `Alibaba`	Video	$0.70 / run	Oct 4, 2026
Wan 3.0 Video Edit `Alibaba`	Video	$1.00 / run	Oct 4, 2026
Wan 3.0 Video Extend `Alibaba`	Video	$0.50 / 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 through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/wan/2.1/vace" 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 and the other models in the catalog; you do not need to sign up with Alibaba separately.