# Wan 3.0 Prime API (Alibaba)

> Wan 3.0 Prime is Alibaba's premium Wan 3.0 tier with higher visual fidelity and motion quality, up to 30 seconds at 1080p with audio.

Page: https://cheapergen.com/models/alibaba/wan-3.0-prime · API reference: https://cheapergen.com/models/alibaba/wan-3.0-prime/api

## Pricing
Official list price source: Alibaba Cloud Model Studio international list price ($0.068 / $0.14 / $0.28 per second; reference-video seconds billed at the same rate). Prices verified 2026-10-14.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 480p | $0.0680/s | $0.0566/s | 17% |
| 720p | $0.1400/s | $0.1132/s | 19% |
| 1080p | $0.2800/s | $0.2263/s | 19% |

## Specs
- Resolutions: 480p · 720p · 1080p
- Duration: 2–30 s
- Aspect ratios: 16:9 · 9:16 · 1:1 · 4:3 · 3:4
- Audio: Yes (included)

## Endpoints

### Text to Video — `POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/text-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| aspect_ratio | string (enum) (16:9, 9:16, 1:1, 4:3, 3:4) | no | Output frame shape. |
| resolution | string (enum) (480p, 720p, 1080p) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (2–30) | no | Length of the generated clip in seconds (2–30s). You pay per second. |
| generate_audio | boolean | no | Generate synchronized sound, ambience and dialogue. No extra cost. |
| negative_prompt | string | no | Things to avoid in the output. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A street-food vendor in Bangkok flips noodles in a flaming wok, night market bokeh, handheld",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'
```

### Image to Video — `POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/image-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| image_url | string (URL) | yes | Image used as the opening frame. JPG/PNG/WebP, URL or upload. |
| resolution | string (enum) (480p, 720p, 1080p) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (2–30) | no | Length of the generated clip in seconds (2–30s). You pay per second. |
| generate_audio | boolean | no | Generate synchronized sound, ambience and dialogue. No extra cost. |
| negative_prompt | string | no | Things to avoid in the output. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Gentle wind moves the curtains; the camera slowly pulls back to reveal the room",
  "image_url": "https://cdn.cheapergen.ai/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}'
```

### Reference to Video — `POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/reference-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| reference_image_urls | string[] (URLs) | no | Up to 4 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… |
| reference_video_urls | string[] (video URLs) | no | Up to 5 MP4/MOV clips for motion, camera moves or effects (1–15 s each, 15 s in total, ≤ 100 MB each). Refer to them as @Video1, @Video2… Reference-video seconds are billed like output seconds; reference + output must be 30 s or less. |
| reference_audio_urls | string[] (audio URLs) | no | Up to 5 MP3/WAV clips for voice, music or sound (1–15 s each, 15 s in total, ≤ 15 MB each). Refer to them as @Audio1, @Audio2… |
| aspect_ratio | string (enum) (16:9, 9:16, 1:1, 4:3, 3:4) | no | Output frame shape. |
| resolution | string (enum) (480p, 720p, 1080p) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (2–30) | no | Length of the generated clip in seconds (2–30s). You pay per second. |
| generate_audio | boolean | no | Generate synchronized sound, ambience and dialogue. No extra cost. |
| negative_prompt | string | no | Things to avoid in the output. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0-prime/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "The woman in @Image1 walks through the café from @Image2 and orders a coffee, moving like @Video1",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg",
    "https://cdn.cheapergen.ai/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'
```

## Getting the result
Jobs are async. Poll `GET https://cheapergen.com/api/v1/generations/{id}` until status is succeeded/failed/canceled, or pass `webhook_url`. Failed generations are refunded automatically.

## FAQ
**How is Wan 3.0 Prime priced?**
Wan 3.0 Prime is billed per second of output video at the selected resolution. In reference-to-video, reference-video seconds are billed at the same rate. Audio is included, and failed generations are never charged.

**How long can a clip be?**
Wan 3.0 Prime generates a single continuous clip of up to 30 seconds — longer than most video models.

**Can I use the output commercially?**
Yes, subject to Alibaba's usage policy and our Terms of Service.

Wan 3.0 Prime is developed by Alibaba. Cheaper Gen. provides API access and does not own the model.