API reference · Alibaba

alibaba/wan-vace

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

IMAGEAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

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

Model IDalibaba/wan-vace

Input Schema

14 parameters · 1 required · 13 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt to guide video generation.
`mask`	string	Optional	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.
`seed`	integer	Optional	Random seed for reproducibility. If None, a random seed is chosen.
`task`	string	Optional	Task type for the model. · Options: depth, inpainting · Default: "depth" depthinpainting
`shift`	number	Optional	Shift parameter for video generation. · Min: 1 · Max: 10 · Default: 5
`video`	string	Optional	URL to the source video file. If provided, the model will use this video as a reference.
`num_frames`	integer	Optional	Number of frames to generate. Must be between 81 to 100 (inclusive). Works only with only reference images as input if source video or mask video is provided output len would be same as source up to 241 frames · Min: 81 · Max: 240 · Default: 81
`preprocess`	boolean	Optional	Whether to preprocess the input video. · Default: false
`resolution`	string	Optional	Resolution of the generated video (480p,580p, or 720p). · Options: 480p, 580p, 720p · Default: "720p" 480p580p720p
`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
`mask_video_url`	string	Optional	URL to the source mask file. If provided, the model will use this mask as a reference.
`ref_image_urls`	string[]	Optional	Urls to source reference image. If provided, the model will use this image as reference.
`frames_per_second`	integer	Optional	Frames per second of the generated video. Must be between 5 to 24. · Min: 5 · Max: 24 · Default: 16
`num_inference_steps`	integer	Optional	Number of inference steps for sampling. Higher values give better quality but take longer. · Min: 2 · Max: 40 · Default: 30

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-vace",
  "task": "depth",
  "shift": 5,
  "video": "https://static.sandbase.ai/examples/alibaba/wan-vace/input_video_0.mp4",
  "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.",
  "num_frames": 81,
  "preprocess": false,
  "resolution": "720p",
  "mask_video_url": "https://static.sandbase.ai/examples/alibaba/wan-vace/input_mask_video_url_2.mp4",
  "ref_image_urls": [
    "https://static.sandbase.ai/examples/alibaba/wan-vace/input_ref_image_urls_1.png"
  ],
  "frames_per_second": 16,
  "num_inference_steps": 30
}'

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

← Back to Vace