Wan

POST/v1/run

Wan 2.2 5b is Alibaba's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to alibaba/wan/2.2/5b/fast/text-to-video.

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

stringpromptrequired

The text prompt to guide video generation.

Optional<string>aspect_ratio

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

Optional<string>resolution

Resolution of the generated video (580p or 720p).

Allowed values: 480p, 580p, 720p

Default: 720p

Optional<number>guidance_scale

Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality.

Range: 1 to 10

Default: 3.5

Optional<integer>seed

Random seed for reproducibility. If None, a random seed is chosen.

Optional<integer>num_interpolated_frames

Number of frames to interpolate between each pair of generated frames. Must be between 0 and 4.

Range: 0 to 4

Default: 0

Optional<integer>num_frames

Number of frames to generate. Must be between 17 to 161 (inclusive).

Range: 17 to 161

Default: 81

Optional<boolean>adjust_fps_for_interpolation

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

Optional<string>video_quality

The quality of the output video. Higher quality means better visual quality but larger file size.

Allowed values: low, medium, high, maximum

Default: high

Optional<integer>frames_per_second

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.

Range: 4 to 60

Default: 24

Optional<boolean>enable_output_safety_checker

If set to true, output video will be checked for safety after generation.

Default: false

Optional<string>interpolator_model

The model to use for frame interpolation. If None, no interpolation is applied.

Allowed values: none, film, rife

Default: film

Optional<string>video_write_mode

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.

Allowed values: fast, balanced, small

Default: balanced

Response Schema

The submit endpoint returns an accepted generation task. Poll the result endpoint with the returned id for terminal outputs or errors.

Optional<string>error

Error message if the task failed. Empty on success.

stringidrequired

Unique identifier for the generation task.

Optional<string>model

Model ID used for the prediction.

Optional<array>outputs

Array of generated content. Empty when status is not completed.

stringstatusrequired

Status of the task: pending, running, completed, failed, or timeout.

Allowed values: pending, running, completed, failed, timeout

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: text-to-video

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async

# 1. Submit a generation request
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -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",
  "aspect_ratio": "21:9"
}'

# 2. If the response is still running, poll the returned id
curl https://api.sandbase.ai/v1/run/run_abc123 \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response202 Accepted

{
  "id": "run_abc123",
  "model": "alibaba/wan/2.2/5b/fast/text-to-video",
  "status": "running",
  "outputs": []
}