# wan2.1

> Generate high-quality videos from images or text with smooth motion, readable text overlay, and support for 480p/720p resolutions; runs efficiently on consumer GPUs, offers 81–100 frames at 5–24 FPS, and enables versatile video editing and generation tasks.

## Overview

- **Model ID**: `wan2.1`
- **Category**: video
- **Provider**: modelslab
- **Status**: model_ready
- **Screenshot**: `https://assets.modelslab.com/generations/04d08a15-bc50-43e7-96e5-5342c249cf50.webp`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v6/video/text2video_ultra`
- **Method**: POST

### Parameters

- **`prompt`** (required): Prompt
  - Type: textarea
  - Example: Placeholder

- **`model_id`** (required): Select the model id
  - Type: select (options: wan2.1, wan2.2)

- **`portrait`** (required): toggle off if you want horizontal video generation
  - Type: toggle

- **`negative_prompt`** (optional): Things that you do not want in video
  - Type: textarea

- **`output_type`** (optional): Output type
  - Type: select (options: mp4, mov)

- **`fps`** (optional): 
  - Type: number (range: 16-25)

- **`num_frames`** (optional): if the fps is 16 and Number of frame is 81 it will generate 5 sec video
  - Type: number (range: 81-120)

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v6/video/text2video_ultra \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "wan2.1",
    "prompt": "astronaut in a spacesuit is jumping and diving on a springboard at competition, front jump, side view, then dives into water, water splash, he is wearing a a spacesuit",
    "portrait": false,
    "negative_prompt": "blurry, low quality, distorted, extra limbs, missing limbs, broken fingers, deformed, glitch, artifacts, unrealistic, low resolution, bad anatomy, duplicate, cropped, watermark, text, logo, jpeg artifacts, noisy, oversaturated, underexposed, overexposed, flicker, unstable motion, motion blur, stretched, mutated, out of frame, bad proportions",
    "output_type": "mp4",
    "fps": "16",
    "num_frames": "81"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v6/video/text2video_ultra",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "wan2.1",
        "prompt": "astronaut in a spacesuit is jumping and diving on a springboard at competition, front jump, side view, then dives into water, water splash, he is wearing a a spacesuit",
        "portrait": False,
        "negative_prompt": "blurry, low quality, distorted, extra limbs, missing limbs, broken fingers, deformed, glitch, artifacts, unrealistic, low resolution, bad anatomy, duplicate, cropped, watermark, text, logo, jpeg artifacts, noisy, oversaturated, underexposed, overexposed, flicker, unstable motion, motion blur, stretched, mutated, out of frame, bad proportions",
        "output_type": "mp4",
        "fps": "16",
        "num_frames": "81"
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v6/video/text2video_ultra", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "wan2.1",
    "prompt": "astronaut in a spacesuit is jumping and diving on a springboard at competition, front jump, side view, then dives into water, water splash, he is wearing a a spacesuit",
    "portrait": false,
    "negative_prompt": "blurry, low quality, distorted, extra limbs, missing limbs, broken fingers, deformed, glitch, artifacts, unrealistic, low resolution, bad anatomy, duplicate, cropped, watermark, text, logo, jpeg artifacts, noisy, oversaturated, underexposed, overexposed, flicker, unstable motion, motion blur, stretched, mutated, out of frame, bad proportions",
    "output_type": "mp4",
    "fps": "16",
    "num_frames": "81"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Links

- [Model Playground](https://modelslab.com/models/text-to-video-ultra/wan2.1)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)