SandBase is live — $1 in free credits on signupStart free ›

Alibaba modelsvideo generation api

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.

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.

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.
URL to the source video file. Required for inpainting.
Resolution of the generated video. Allowed values: auto, 240p, 360p, 480p, 720p.
Random seed for reproducibility. If None, a random seed is chosen.
Idle

Example output — click Run to generate your own

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

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

Technical Specs

SpecValue
Model IDalibaba/wan/2.1/vace/inpainting
Input fieldsmask (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 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

Related Models

alibaba/wan/2.1/vaceWan 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.alibaba/wan/2.1/vace/depthWan 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.alibaba/wan/2.1/vace/long-reframeWan 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.alibaba/wan/2.1/vace/outpaintingWan 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.alibaba/wan/2.1/vace/poseWan 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.alibaba/wan/2.1/vace/reframeWan 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.alibaba/wan/2.1/vace/video-editWan 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.alibaba/wan/2.1/image-to-video/loraWan 2.1 Lora is Alibaba's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.