Wan 3.0 Prime Reference to Video

Name: Alibaba Wan 3.0 Prime Reference to Video
Price: 0.595 USD
Availability: InStock
Author: Alibaba

15% OFFalibaba/wan/3.0/prime/reference-to-video

Wan 3.0 Prime by Alibaba generates up to 30-second videos with native audio from reference images, videos, and audio, keeping subjects, motion, and voice consistent with the references.

Use in agent Get API key

Base price: $0.59~~$0.70~~USD / run
Execution: async
Model type: video
Input fields: 9

Production route

Try the model

Playground

Open playground

Input

Prompt(string)

Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'.

Images(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 10

Up to 10 reference image URLs (JPEG, PNG, BMP, or WebP; up to 20MB each, 240-8000px per side). Refer to them in the prompt as Image 1, Image 2, and so on. Provide at least one of `images`, `videos`, or `audios`.

Videos(array)

Up to 5 reference video URLs (MP4 or MOV; 1-15s each, 15s total, under 100MB each). Cannot be combined with `image` or `end_image`.

Audios(array)

Up to 5 reference audio URLs (WAV or MP3; 1-15s each, 15s total, under 15MB each). Cannot be combined with `image` or `end_image`.

Duration

Output duration in seconds (2-30), or `auto` to let the model pick a length from the prompt and inputs. `auto` is pre-authorized at 30 seconds and billed on the actual output length. Allowed values: auto, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30.

Aspect Ratio(string)

Output aspect ratio. Omit to let the model choose from the prompt and reference inputs. Allowed values: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Resolution(string)

Output video resolution tier. Allowed values: 480p, 720p, 1080p.

Generate Audio(boolean)

Generate a synchronized audio track. Pricing is the same either way.

Seed(integer)

Random seed (0-2147483647) for reproducible results. Omit for a random seed; the same seed may still produce slightly different results. Range: 0 to 2147483647.

15% OFF

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.59 / run

Context & modalities

Input: Schema-defined
Output: video

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Alibaba
Model ID: alibaba/wan/3.0/prime/reference-to-video
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

Wan 3.0 Prime Reference to Video

Generate a new shot that reuses what you already have: faces and products from images, motion and framing from clips, voices and music from audio. The prompt decides how the references come together.

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.
`images`	image URL[] (≤10)	—	Referenced as Image 1, Image 2, …
`videos`	video URL[] (≤5)	—	MP4/MOV, 1–15s each, 15s total, ≤100MB. Referenced as Video 1, …
`audios`	audio URL[] (≤5)	—	WAV/MP3, 1–15s each, 15s total, ≤15MB. Referenced as Audio 1, …
`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.

Send at least one of images, videos, or audios; any combination works.

Billing

You pay per second of output plus, when you send reference videos, their total length (rounded up, counted up to 15s): $0.068 at 480p, $0.14 at 720p, $0.28 at 1080p. Input images and audio are not metered. If the reference video length cannot be read, 15s is assumed.

Request	Billed	480p	720p	1080p
5s output (default)	5s	$0.34	$0.70	$1.40
10s output	10s	$0.68	$1.40	$2.80
30s output	30s	$2.04	$4.20	$8.40
5s output + 8s reference video	13s	$0.884	$1.82	$3.64
5s output + 15s reference videos	20s	$1.36	$2.80	$5.60

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

Give every reference a job: “Image 1 is the cyclist, Video 1 provides the camera move.”
Several images of the same subject from different angles hold identity better than one.
Keep reference audio short and focused on the voice or sound you want carried over.

Image 1 is the cyclist; Video 1 supplies the camera movement. She rides through a rainy city at night in the same red jacket, with quiet traffic in the background.

Limits

Up to 10 images, 5 videos (15s total), and 5 audio clips (15s total).
Reference video length plus output length must stay within 30 seconds.
First/last frames are not accepted here; use image-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/text-to-video, alibaba/wan/3.0/prime/image-to-video, alibaba/wan/3.0/prime/video-edit, alibaba/wan/3.0/prime/video-extend. Standard tier: alibaba/wan/3.0/reference-to-video.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

alibaba/wan/3.0/prime/reference-to-video

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "alibaba/wan/3.0/prime/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/bytedance/seedance/2.0/reference-to-video/input_image_safe_ocean_0.jpg"
  ],
  "duration": 5,
  "resolution": "720p",
  "generate_audio": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
Wan 3.0 Prime Reference to VideoThis model `Alibaba`	Video	$0.70 / run	Aug 24, 2026
Wan 3.0 Prime Video Edit `Alibaba`	Video	$1.40 / run	Oct 4, 2026
Wan 3.0 Prime Video Extend `Alibaba`	Video	$0.70 / run	Oct 4, 2026
Wan 3.0 Video Edit `Alibaba`	Video	$1.00 / run	Oct 4, 2026
Wan 3.0 Video Extend `Alibaba`	Video	$0.50 / run	Oct 4, 2026
Wan 3.0 Prime Text to Video `Alibaba`	Video	$0.70 / run	Aug 24, 2026

Questions

FAQ

How do I call Alibaba Wan 3.0 Prime Reference to Video through SandBase?

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