> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# Wan 2.5

> Alibaba's Wan 2.5 video model with text-to-video and image-to-video, native audio, optional custom audio tracks, and 480p to 1080p output.

![Wan 2.5](https://media.empiriolabs.ai/model-logos/wan.png)

[Alibaba Cloud](/providers/alibaba) · Video Generation

`POST /v1/videos/generations`

Alibaba's Wan 2.5 video model with text-to-video and image-to-video, native audio, optional custom audio tracks, and 480p to 1080p output.

## At a glance

| Field               | Value                                |
| ------------------- | ------------------------------------ |
| Model id            | `wan-2-5`                            |
| Model release date  | 2025-09-24                           |
| Input modalities    | Text, Image                          |
| Output modalities   | Video                                |
| Context window      | -                                    |
| Weight precision    | -                                    |
| Region              | Singapore                            |
| Features            | text_to_video, image_to_video, audio |
| Native inference    | No                                   |
| New                 | No                                   |
| Supported endpoints | `POST /v1/videos/generations`        |
| Alternate model ids | `alibaba/wan-2.5`, `wan2.5`          |

## Pricing

| Charge | Spec       | Rate   |
| ------ | ---------- | ------ |
| 480P   | per second | \$0.05 |
| 720P   | per second | \$0.10 |
| 1080P  | per second | \$0.15 |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/videos/generations \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "wan-2-5", "prompt": "sunrise over the ocean", "duration": 6}'
```

## Parameters

| Parameter         | Type    | Required | Default   | Description                                                                                                                                             |
| ----------------- | ------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`          | string  | yes      | -         | Scene description.                                                                                                                                      |
| `mode`            | enum    | no       | `"auto"`  | Auto detects from attachments. t2v: text-to-video. i2v: animate one image. · Allowed: `auto`, `t2v`, `i2v`                                              |
| `resolution`      | enum    | no       | `"1080p"` | Output resolution. · Allowed: `480p`, `720p`, `1080p`                                                                                                   |
| `duration`        | integer | no       | `5`       | Clip length in seconds: 5 or 10. · Range: 5 – 10 · Allowed: `5`, `10`                                                                                   |
| `aspect_ratio`    | enum    | no       | `"16:9"`  | Used for text-to-video; image-to-video follows the source image. 480p supports 16:9, 9:16, and 1:1 only. · Allowed: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` |
| `image`           | string  | no       | -         | Source image URL for i2v.                                                                                                                               |
| `audio_url`       | string  | no       | -         | Optional custom audio track URL (WAV or MP3, about 3 to 30 seconds). Without it the model generates native audio.                                       |
| `negative_prompt` | string  | no       | `""`      | What to avoid.                                                                                                                                          |
| `seed`            | number  | no       | -         | Reproducibility seed.                                                                                                                                   |
| `prompt_extend`   | boolean | no       | true      | Let the service rewrite the prompt for better results.                                                                                                  |
| `watermark`       | boolean | no       | false     | Add a provenance watermark to the output.                                                                                                               |

## Notes

Modes: text-to-video and image-to-video with native audio, or supply audio_url for a custom track (WAV or MP3, about 3 to 30 seconds). Durations are 5 or 10 seconds. 480p output supports 16:9, 9:16, and 1:1.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/wan-2-5`.