AlibabavideoBest valueUnavailable

Wan 3.0 Reference to Video API

Name: Wan 3.0 API
Brand: Alibaba
Availability: OutOfStock

Reference to Video with Wan 3.0 by Alibaba. Up to 30-second videos with audio from Alibaba.

alibaba/wan-3.0/reference-to-video

FromUp to −51%

$0.025/s$0.05

per second of video · 480p

Open in Studio API

Try Wan 3.0 Reference to Video

Prompt*

Type @ to point at a reference image, video or audio clip0/5000

Reference images

Up to 4 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2…

Reference videos

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

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

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (2–30s). You pay per second.

Generate audio

Generate synchronized sound, ambience and dialogue. No extra cost.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: Wan 3.0 Text to Video · Wan 3.0 Image to Video

Wan 3.0 Reference to Video API

POST/api/v1/run/alibaba/wan-3.0/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`	string[] (URLs)	Up to 4 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… Max items: 4	No
`reference_video_urls`	string[] (video URLs)	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. Max items: 5	Yes
`reference_audio_urls`	string[] (audio URLs)	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… Max items: 5	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480p · 720p · 1080p Default: 720p	Yes
`duration`	integer	Length of the generated clip in seconds (2–30s). You pay per second. Range: 2–30s Default: 5	Yes
`generate_audio`	boolean	Generate synchronized sound, ambience and dialogue. No extra cost. Default: true	No
`negative_prompt`	string	Things to avoid in the output.	No
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

curl -X POST https://cheapergen.com/api/v1/run/alibaba/wan-3.0/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
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/alibaba/wan-3.0/reference-to-video", headers=headers, json={
    "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
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/alibaba/wan-3.0/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0",
  "endpoint": "alibaba/wan-3.0/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "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
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "alibaba/wan-3.0",
  "endpoint": "alibaba/wan-3.0/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "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
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Wan 3.0 pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
480p per second	~~$0.05~~/s	$0.025/s	−51%
720p per second	~~$0.10~~/s	$0.049/s	−51%
1080p per second	~~$0.20~~/s	$0.099/s	−51%

Official price: Alibaba Cloud Model Studio international list price ($0.05 / $0.10 / $0.20 per second; reference-video seconds billed at the same rate). Prices verified 2026-10-14.
Reference-video seconds are billed at the same per-second rate as the output.

About Wan 3.0 All Wan 3.0 endpoints