alibaba/wan/2.1/vace/outpainting

Name: Wan 2.1 VACE Outpainting
Author: Alibaba

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.

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.

Video URL(string)

URL to the source video file. Required for outpainting.

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.

Expand Left(boolean)

Whether to expand the video to the left.

Expand Top(boolean)

Whether to expand the video to the top.

Expand Right(boolean)

Whether to expand the video to the right.

Expand Ratio(number)

Amount of expansion. This is a float value between 0 and 1, where 0.25 adds 25% to the original video size on the specified sides. Range: 0 to 1.

Expand Bottom(boolean)

Whether to expand the video to the bottom.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

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

Model IDalibaba/wan/2.1/vace/outpainting

Input Schema

10 parameters · 1 required · 9 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt to guide video generation.
`seed`	integer	Optional	Random seed for reproducibility. If None, a random seed is chosen.
`video`	string	Optional	URL to the source video file. Required for outpainting.
`expand_top`	boolean	Optional	Whether to expand the video to the top. · Default: false
`resolution`	string	Optional	Resolution of the generated video. · Options: auto, 240p, 360p, 480p, 720p · Default: "auto" auto240p360p480p720p
`expand_left`	boolean	Optional	Whether to expand the video to the left. · Default: false
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`expand_ratio`	number	Optional	Amount of expansion. This is a float value between 0 and 1, where 0.25 adds 25% to the original video size on the specified sides. · Min: 0 · Max: 1 · Default: 0.25
`expand_right`	boolean	Optional	Whether to expand the video to the right. · Default: false
`expand_bottom`	boolean	Optional	Whether to expand the video to the bottom. · Default: false

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "alibaba/wan/2.1/vace/outpainting",
  "video": "https://static.sandbase.ai/examples/alibaba/wan/2.1/vace/outpainting/input_video_0.mp4",
  "prompt": "A lone woman strides through the neon-drenched streets of Tokyo at night.  Her crimson dress, a vibrant splash of color against the deep blues and blacks of the cityscape, flows slightly with each step. A tailored black jacket, crisp and elegant, contrasts sharply with the dress's rich texture. Medium shot:  The city hums around her, blurred lights creating streaks of color in the background. Close-up:  The fabric of her dress catches the streetlight's glow, revealing a subtle silk sheen and the intricate stitching at the hem. Her black jacket’s subtle texture is visible – a fine wool perhaps, with a matte finish. The overall mood is one of quiet confidence and mystery, a vibrant woman navigating a bustling, nocturnal landscape. High resolution 4k.",
  "expand_top": true,
  "resolution": "auto",
  "expand_left": true,
  "expand_ratio": 0.25,
  "expand_right": true,
  "expand_bottom": true
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Wan 2.1 VACE Outpainting

API README

Wan 2.1 VACE Outpainting

Wan 2.1 VACE Outpainting is a Wan-family route for video outpainting. 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 video outpainting. 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

Canvas extension. Generates new scene content beyond the original video boundary.
Temporal edge continuity. Keeps extended regions coherent with adjacent source frames over time.
Perspective completion. Infers plausible environment, geometry, lighting, and motion outside the initial frame.
Prompt-directed expansion. Uses the brief to determine what the wider composition should reveal.

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",
  "seed": 1,
  "video": "https://example.com/source.mp4",
  "expand_top": false
}

Technical Specs

Spec	Value
Model ID	`alibaba/wan/2.1/vace/outpainting`
Input fields	`seed` (integer)<br>`video` (string)<br>`prompt` (string)<br>`expand_top` (boolean)<br>`resolution` (string; `auto`, `240p`, `360p`, `480p`, `720p`)<br>`expand_left` (boolean)<br>`aspect_ratio` (string; `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`)<br>`expand_ratio` (number)<br>`expand_right` (boolean)<br>`expand_bottom` (boolean)
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