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

Alibaba modelsvideo generation api

alibaba/wan/2.1/vace/video-edit

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
Prompt to edit the video.

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

URLs of the input images to use as a reference for the generation.
URL of the input video.
Resolution of the edited video. Allowed values: auto, 240p, 360p, 480p, 720p.
The type of video you're editing. Use 'general' for most videos, and 'human' for videos emphasizing human subjects and motions. The default value 'auto' means the model will guess based on the first frame of the video. Allowed values: auto, general, human.
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.
Idle

Example output — click Run to generate your own

API README

Wan 2.1 VACE Video Edit

Wan 2.1 VACE Video Edit is the Wan 2.1 workflow for source-video transformation. 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 source-video transformation. 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 Temporal source editing. Changes an existing clip while retaining its timeline and scene foundation.
  • 2.1 Cross-frame edit consistency. Applies the transformation coherently instead of independently per frame.
  • 2.1 Semantic scene revision. Changes objects, style, environment, or presentation through written direction.
  • 2.1 Motion and identity preservation. Retains important subject movement and recognizable content where requested.

Pricing

ConfigurationModePrice
autoPer generated second$0.05
240pPer generated second$0.05
360pPer generated second$0.05
480pPer generated second$0.05
720pPer generated second$0.10

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",
  "video": "https://example.com/source.mp4",
  "images": [],
  "resolution": "auto"
}

Technical Specs

SpecValue
Model IDalibaba/wan/2.1/vace/video-edit
Input fieldsvideo (string)<br>images (array)<br>prompt (string)<br>resolution (string; auto, 240p, 360p, 480p, 720p)<br>video_type (string; auto, general, human)<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/inpaintingWan 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/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/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.