API reference · Alibaba

alibaba/wan/2.2/5b/fast/text-to-video

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

VIDEOAsyncOpen 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/2.2/5b/fast/text-to-video

Input Schema

13 parameters · 1 required · 12 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.
`num_frames`	integer	Optional	Number of frames to generate. Must be between 17 to 161 (inclusive). · Min: 17 · Max: 161 · Default: 81
`resolution`	string	Optional	Resolution of the generated video (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
`video_quality`	string	Optional	The quality of the output video. Higher quality means better visual quality but larger file size. · Options: low, medium, high, maximum · Default: "high" lowmediumhighmaximum
`guidance_scale`	number	Optional	Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality. · Min: 1 · Max: 10 · Default: 3.5
`video_write_mode`	string	Optional	The write mode of the output video. Faster write mode means faster results but larger file size, balanced write mode is a good compromise between speed and quality, and small write mode is the slowest but produces the smallest file size. · Options: fast, balanced, small · Default: "balanced" fastbalancedsmall
`frames_per_second`	integer	Optional	Frames per second of the generated video. Must be between 4 to 60. When using interpolation and `adjust_fps_for_interpolation` is set to true (default true,) the final FPS will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If `adjust_fps_for_interpolation` is set to false, this value will be used as-is. · Min: 4 · Max: 60 · Default: 24
`interpolator_model`	string	Optional	The model to use for frame interpolation. If None, no interpolation is applied. · Options: none, film, rife · Default: "film" nonefilmrife
`num_interpolated_frames`	integer	Optional	Number of frames to interpolate between each pair of generated frames. Must be between 0 and 4. · Min: 0 · Max: 4 · Default: 0
`adjust_fps_for_interpolation`	boolean	Optional	If true, the number of frames per second will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If false, the passed frames per second will be used as-is. · Default: true
`enable_output_safety_checker`	boolean	Optional	If set to true, output video will be checked for safety after generation. · 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.2/5b/fast/text-to-video",
  "prompt": "A medium shot establishes a modern, minimalist office setting: clean lines, muted grey walls, and polished wood surfaces. The focus shifts to a close-up on a woman in sharp, navy blue business attire. Her crisp white blouse contrasts with the deep blue of her tailored suit jacket. The subtle texture of the fabric is visible—a fine weave with a slight sheen. Her expression is serious, yet engaging, as she speaks to someone unseen just beyond the frame. Close-up on her eyes, showing the intensity of her gaze and the fine lines around them that hint at experience and focus. Her lips are slightly parted, as if mid-sentence. The light catches the subtle highlights in her auburn hair, meticulously styled. Note the slight catch of light on the silver band of her watch. High resolution 4k",
  "num_frames": 81,
  "resolution": "720p",
  "video_quality": "high",
  "guidance_scale": 3.5,
  "video_write_mode": "balanced",
  "frames_per_second": 24,
  "interpolator_model": "film",
  "num_interpolated_frames": 0,
  "adjust_fps_for_interpolation": true,
  "enable_output_safety_checker": false
}'

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

← Back to Wan