# Alibaba Wan 3.0 Image to Video API

> Wan 3.0 by Alibaba - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.

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

## Facts

- Provider: Alibaba
- Type: Video model
- Model ID: `alibaba/wan/3.0/image-to-video`
- Price: From $0.33 per run (35% off list price)
- Capabilities: image 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/image-to-video",
  "image": "https://static.sandbase.ai/samples/image-to-video/i2v-black-cat-sky-img0.png",
  "duration": 5,
  "resolution": "720p",
  "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 Image to Video through SandBase?

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

## README

### Wan 3.0 Image to Video

Start a clip from your own picture. `image` becomes the exact first frame; add `end_image` and the model interpolates the motion between the two. Clips run 2–30 seconds with native audio.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Up to 5,000 characters. |
| `image` | image URL, required | — | First frame. JPEG/PNG/BMP/WebP, 240–8000px per side, ≤20MB, no transparency. |
| `end_image` | image URL | — | Last frame; needs `image`. |
| `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.05 at 480p, $0.10 at 720p, $0.20 at 1080p. Input images, audio, and video are not metered. The frame images are free.

| Output | Billed | 480p | 720p | 1080p |
|---|---|---|---|---|
| 2s | 2s | $0.10 | $0.20 | $0.40 |
| 5s (default) | 5s | $0.25 | $0.50 | $1.00 |
| 10s | 10s | $0.50 | $1.00 | $2.00 |
| 30s | 30s | $1.50 | $3.00 | $6.00 |

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

- Describe what moves, not what is already visible: “she turns toward the lens as wind lifts her scarf”.
- With two frames, keep them compatible in framing and lighting, or describe the transition explicitly.
- Leave `aspect_ratio` on `adaptive` to keep the image's own proportions.

> The subject slowly turns toward the camera as a breeze moves the fabric; subtle handheld push-in, natural daylight, no dialogue.

#### Limits

- Reference images, videos, and audio are not accepted here; use reference-to-video instead.

#### Also on SandBase

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