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 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