API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Wan 2.1 VACE Depth

alibaba/wan/2.1/vace/depth

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.

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

Try the model

Playground

Open playground
Input
The text prompt to guide video generation.
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.
URL to the source video file. Required for depth task.
Resolution of the generated video. Allowed values: auto, 240p, 360p, 480p, 720p.
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/depth
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Wan 2.1 VACE Depth

Wan 2.1 VACE Depth is a Wan-family route for depth-guided video generation. 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 depth-guided video generation. 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

  • Depth-conditioned geometry. Uses a depth sequence to preserve spatial structure and three-dimensional relationships.
  • Controlled scene re-rendering. Changes appearance while following the supplied geometry over time.
  • Temporal structural consistency. Keeps the depth-guided layout stable across consecutive frames.
  • Prompt-directed finish. Uses written direction for subjects, materials, lighting, and atmosphere around the structural condition.

Pricing

ResolutionBilling unitPrice
autoPer generated second$0.040
240pPer generated second$0.040
360pPer generated second$0.040
480pPer generated second$0.040
720pPer generated second$0.080

When to Use

✅ Good fit❌ Consider alternatives
The project needs this exact named workflowThe intended task belongs to another media route
All required reference or control media is availableNecessary assets or rights are unavailable
The brief can state transformation and preservation goalsOutput must be deterministic at pixel or frame level
Supported duration, resolution, and format fit deliveryFinal placement requires unsupported specifications
An asynchronous generated result fits productionA 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",
  "seed": 1,
  "video": "https://example.com/source.mp4",
  "resolution": "auto"
}

Technical Specs

SpecValue
Model IDalibaba/wan/2.1/vace/depth
Input fieldsseed (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 inputprompt
Output fieldsurl, content_type
ExecutionAsynchronous 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/depth
# 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/depth",
  "video": "https://static.sandbase.ai/examples/alibaba/wan/2.1/vace/depth/input_video_0.mp4",
  "prompt": "A confident woman strides toward the camera down a sun-drenched, empty street. Her vibrant summer dress, a flowing emerald green with delicate white floral embroidery, billows slightly in the gentle breeze.  She carries a stylish, woven straw bag, its natural tan contrasting beautifully with the dress. The dress's fabric shimmers subtly, catching the light. The white embroidery is intricate, each tiny flower meticulously detailed.  Her expression is focused, yet relaxed, radiating self-assuredness. Her auburn hair, partially pulled back in a loose braid, catches the sunlight, creating warm highlights. The street itself is paved with warm, grey cobblestones, reflecting the bright sun. The mood is optimistic and serene, emphasizing the woman's independence and carefree spirit. High resolution 4k",
  "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
ModelTypeDefault priceReleased
AlibabaVideo$0.20 / runJun 18, 2025
AlibabaVideo$0.50 / runOct 5, 2026
AlibabaVideo$0.50 / runOct 5, 2026
AlibabaVideo$1.40 / runOct 4, 2026
AlibabaVideo$0.70 / runOct 4, 2026
AlibabaVideo$1.00 / runOct 4, 2026

Questions

FAQ

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

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