# Alibaba Wan 3.0 Prime Text to Video API

> Wan 3.0 Prime by Alibaba turns a text prompt into a video of up to 30 seconds at 30fps, with native dialogue, music, and sound effects.

Source: https://www.sandbase.ai/models/alibaba/wan/3.0/prime/text-to-video
API reference: https://www.sandbase.ai/models/alibaba/wan/3.0/prime/text-to-video/docs

## Facts

- Provider: Alibaba
- Type: Video model
- Model ID: `alibaba/wan/3.0/prime/text-to-video`
- Price: From $0.45 per run (35% off list price)
- 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/3.0/prime/text-to-video",
  "prompt": "A red panda walking through a bamboo forest at sunrise",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}'
```

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 3.0 Prime Text to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/wan/3.0/prime/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 3.0 Prime Text to Video and the other models in the catalog; you do not need to sign up with Alibaba separately.

## README

### Wan 3.0 Prime Text to Video

Write a scene and get back a 2–30 second, 30fps clip with matching dialogue, music, and sound effects. No images or reference media are needed.

Prime is the faster Wan 3.0 tier: the same inputs and output quality as standard Wan 3.0, with significantly shorter end-to-end generation time and a higher per-second rate. Use standard Wan 3.0 for batch or background jobs where turnaround does not matter.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Up to 5,000 characters. |
| `duration` | 2–30 or `auto` | 5 | `auto` lets the model pick the length. |
| `resolution` | `480p` / `720p` / `1080p` | `720p` | Sets the per-second rate. |
| `aspect_ratio` | `adaptive` / `21:9` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` | `adaptive` | `adaptive` follows the prompt and inputs. |
| `generate_audio` | boolean | true | Native dialogue, music, and effects. Same price on or off. |
| `seed` | integer 0–2147483647 | random | Fix it to compare prompt changes. |

#### Billing

You pay for output seconds only: $0.068 at 480p, $0.14 at 720p, $0.28 at 1080p. Input images, audio, and video are not metered.

| Output | Billed | 480p | 720p | 1080p |
|---|---|---|---|---|
| 2s | 2s | $0.136 | $0.28 | $0.56 |
| 5s (default) | 5s | $0.34 | $0.70 | $1.40 |
| 10s | 10s | $0.68 | $1.40 | $2.80 |
| 30s | 30s | $2.04 | $4.20 | $8.40 |

With `duration: "auto"` the run is pre-authorized at 30 seconds, then settled on the length that was actually generated. Failed runs are not charged. Output files are copied to SandBase storage and the returned URL stays valid for 7 days; download anything you need to keep.

#### Prompting

- Cover subject, action, setting, camera, light, and sound in one or two sentences each.
- Spell out camera timing, e.g. “holds for two seconds, then cranes up over the rooftops”.
- Quote dialogue and say who speaks it.

> At night a kitten trots along a wet rooftop; neon signs flicker across the city behind it. Low tracking shot that rises as it leaps a gap, soft rain and distant traffic.

#### Limits

- This endpoint accepts no media inputs. To animate a picture use image-to-video; to steer with references use reference-to-video.

#### Also on SandBase

Other Wan 3.0 Prime endpoints: `alibaba/wan/3.0/prime/video` (all modes in one schema), `alibaba/wan/3.0/prime/image-to-video`, `alibaba/wan/3.0/prime/reference-to-video`, `alibaba/wan/3.0/prime/video-edit`, `alibaba/wan/3.0/prime/video-extend`. Standard tier: `alibaba/wan/3.0/text-to-video`.
