Wan 2.1 (Text-to-Video)

This documentation is valid for the following list of our models:

• wan/v2.1/1.3b/text-to-video

Overview

A state-of-the-art video foundation model designed for advanced generative video tasks. Supporting Text-to-Video (T2V), it incorporates groundbreaking innovations to deliver high-quality outputs with exceptional computational efficiency.

Key Features:

• Visual text generation: Generates text in both Chinese and English within videos.

• Output Quality: Produces videos at resolutions up to 720P with a frame rate of approximately 16 .

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

How to Make a Call

Generating a video using this model involves sequentially calling two endpoints:

• The first one is for creating and sending a video generation task to the server (returns a generation ID).

• The second one is for requesting the generated video from the server using the generation ID received from the first endpoint.

Below, you can find two corresponding API schemas and examples for both endpoint calls.

API Schemas

Video Generation

This endpoint creates and sends a video generation task to the server — and returns a generation ID.

post

Authorizations

Body

modelundefined · enumRequiredPossible values:

promptstringRequired

The text prompt to guide video generation.

Example: Mona Lisa puts on glasses with her hands

negative_promptstringOptional

The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).

seedintegerOptional

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

aspect_ratiostring · enumOptional

Aspect ratio of the generated video (16:9 or 9:16).

Default: 16:9Possible values:

inference_stepsintegerOptional

Number of inference steps for sampling. Higher values give better quality but take longer.

Default: 30

guidance_scalenumberOptional

Classifier-free guidance scale. Controls prompt adherence / creativity.

Default: 5

shiftnumberOptional

Noise schedule shift parameter. Affects temporal dynamics.

Default: 5

samplerstring · enumOptional

The sampler to use for generation.

Default: unipcPossible values:

enable_safety_checkerbooleanOptional

If set to true, the safety checker will be enabled.

enable_prompt_expansionbooleanOptional

Whether to enable prompt expansion.

Responses

201Success

post

HTTPcURLJavaScriptPython

POST /v2/generate/video/alibaba/generation HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer <YOUR_AIMLAPI_KEY>
Content-Type: application/json
Accept: */*
Content-Length: 275

{
  "model": "wan/v2.1/1.3b/text-to-video",
  "prompt": "Mona Lisa puts on glasses with her hands",
  "negative_prompt": "text",
  "seed": 1,
  "aspect_ratio": "16:9",
  "inference_steps": 30,
  "guidance_scale": 5,
  "shift": 5,
  "sampler": "unipc",
  "enable_safety_checker": true,
  "enable_prompt_expansion": true
}

201Success

No content

Fetch the video

This endpoint lets you request the generated video from the server using the generation ID received from the first endpoint.

get

Authorizations

Query parameters

generation_idstringRequired

Responses

200Success

get

HTTPcURLJavaScriptPython

GET /v2/generate/video/alibaba/generation HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer <YOUR_AIMLAPI_KEY>
Accept: */*

200Success

No content

Examples

Video generation

import requests


def main():
    url = "https://api.aimlapi.com/v2/generate/video/alibaba/generation"
    payload = {
        "model": "wan/v2.1/1.3b/text-to-video",
        "prompt": "A DJ on the stand is playing, around a World War II battlefield, lots of explosions, thousands of dancing soldiers, between tanks shooting, barbed wire fences, lots of smoke and fire, black and white old video: hyper realistic, photorealistic, photography, super detailed, very sharp, on a very white background",
        "aspect_ratio": "16:9",
    }
    headers = {"Authorization": "Bearer <YOUR_AIMLAPI_KEY>", "Content-Type": "application/json"}

    response = requests.post(url, json=payload, headers=headers)
    print("Generation:", response.json())


if __name__ == "__main__":
    main()

Fetch the video

import requests


def main():
    url = "https://api.aimlapi.com/v2/generate/video/alibaba/generation"
    params = {
        "generation_id": "<YOUR_GENERATION_ID>",
    }
    headers = {"Authorization": "Bearer <YOUR_AIMLAPI_KEY>", "Content-Type": "application/json"}

    response = requests.get(url, params=params, headers=headers)
    print("Generation:", response.json())


if __name__ == "__main__":
    main()