# Alibaba Wan 2.5 Text to Video API

> Wan 2.5 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.

Source: https://www.sandbase.ai/model/alibaba/wan/2.5/text-to-video
API reference: https://www.sandbase.ai/model/alibaba/wan/2.5/text-to-video/docs

## Facts

- Provider: Alibaba
- Type: Video model
- Model ID: `alibaba/wan/2.5/text-to-video`
- Price: From $0.50 per run
- Capabilities: text to video
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/wan/2.5/text-to-video",
  "prompt": "The white dragon warrior stands still, eyes full of determination and strength. The camera slowly moves closer or circles around the warrior, highlighting the powerful presence and heroic spirit of the character.",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Alibaba Wan 2.5 Text to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/wan/2.5/text-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Alibaba account?

No. One SandBase API key and balance gives you access to Alibaba Wan 2.5 Text to Video and the other models in the catalog; you do not need to sign up with Alibaba separately.

## README

### Wan 2.5 Text to Video

Wan 2.5 text-to-video: a 5 or 10 second clip from a written scene, with optional driving audio. Newer Wan versions are listed below.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Text instruction. |
| `aspect_ratio` | `16:9` / `9:16` / `1:1` / `4:3` / `3:4` | `16:9` | Output frame shape. |
| `audio` | audio URL | — | Optional WAV/MP3 URL that drives speech or rhythm. |
| `resolution` | `480p` / `720p` / `1080p` | `720p` | Sets the per-second rate. |
| `duration` | 5 / 10 | 5 | Output length in seconds. |
| `seed` | integer | random | Fix it to compare prompt changes. |

#### Billing

You pay for output seconds: $0.05 at 480p, $0.10 at 720p, and $0.15 at 1080p.

| Output | 480p | 720p | 1080p |
|---|---|---|---|
| 5s (default) | $0.25 | $0.50 | $0.75 |
| 10s | $0.50 | $1.00 | $1.50 |

Failed runs are not charged.

#### Prompting

- Describe the shot in order: subject, action, setting, camera move, light, and sound.
- Give camera timing explicitly, e.g. “holds for two seconds, then pushes in slowly”.

#### Limits

- Durations are 5 or 10 seconds only.

#### Also on SandBase

Other Wan 2.5 endpoints: `alibaba/wan/2.5/image-to-video`, `alibaba/wan/2.5/text-to-image`, `alibaba/wan/2.5/image-to-image`, `alibaba/wan/2.7/text-to-video` (newer).