Start building
SandBase

Appearance

Wan Alpha

POST/v1/run

Wan Alpha 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/alpha.

Default: alibaba/wan/alpha

stringpromptrequired

The prompt to guide the 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

The resolution of the generated video.

Allowed values: 240p, 360p, 480p, 720p

Default: 480p

Optional<integer>seed

The seed for the random number generator.

Optional<string>video_output_type

The output type of the generated video.

Allowed values: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif)

Default: VP9 (.webm)

Optional<boolean>binarize_mask

Whether to binarize the mask.

Default: false

Optional<integer>fps

The frame rate of the generated video.

Range: 1 to 60

Default: 16

Optional<number>mask_binarization_threshold

The threshold for mask binarization. When binarize_mask is True, this threshold will be used to binarize the mask. This will also be used for transparency when the output type is `.webm`.

Range: 0 to 1

Default: 0.8

Optional<number>mask_clamp_upper

The upper bound of the mask clamping.

Range: 0 to 1

Default: 0.75

Optional<number>mask_clamp_lower

The lower bound of the mask clamping.

Range: 0 to 1

Default: 0.1

Response Schema

The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.

stringidrequired

Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.

stringstatusrequired

Current public run status.

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

Optional<string>model

Public SandBase model name used for this run.

Optional<array<object>>outputs

Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.

Optional<object>error

Present only for failed or timeout runs. Contains a public error type and sanitized message.

Optional<string>error.type

Stable public error category.

Optional<string>error.message

Sanitized error message safe to show to clients.

Optional<object>usage

Usage details when available.

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