Wan 3.0 API

Introduction

Wan 3.0 Reference to video builds a new 2 to 30 second shot from supplied references: up to ten images, five video clips and five audio clips in one request. At least one of reference_image_urls, reference_video_urls, reference_audio_urls, reference_file_url or reference_link_url must be present, and the prompt is optional. Use it when a face, a garment, a location or a voice has to stay the same across separately rendered shots — something text-to-video cannot do, because it invents a new face on every run. Output is 480p, 720p or 1080p, default 720p.

Choose a Wan 3.0 mode by starting material

Key features

Images for identity, wardrobe and sets

reference_image_urls takes 1 to 10 images — character plates, garment plates, set plates — as JPEG, PNG without transparency, BMP or WEBP, 240 to 8000 pixels per side and up to 20 MB each. Name each one in the prompt, or the model averages them into a subject that resembles none of them.

Video for movement, audio for voice

Reference videos carry movement and camera style rather than a face: up to five MP4 or MOV clips, each 1 to 15 seconds and 15 seconds in total, at least 16 fps. Reference audio carries a voice, a line reading or room tone: up to five WAV or MP3 clips, also 15 seconds in total. These limits are checked during generation rather than when the task is accepted, so measure your clips before you submit.

A 30-second budget shared with the output

A 12-second motion reference therefore leaves room for an output of at most 18 seconds. Reference images and reference audio do not count toward that budget.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 34 credits for a 5-second clip ($0.34).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Re-rendering the same performer in a known room

Image 2 is the room." She then crosses to the window under a slow lateral track, 8 seconds at 720p with seed 771120. Keeping both plates and the seed fixed while changing only the action line is the request shape for episodic work.

A speaker with a matched voice

The monologue example pairs one image plate for the speaker's face and wardrobe with one audio reference for her voice. The prompt keeps those roles apart, then describes a locked medium shot at a kitchen table in morning light, 10 seconds at 720p. Presenters, narrators and recurring characters who must sound the same across takes follow this pattern.

Prompt guide & pro tips

Map every reference before describing the shot

Open the prompt with one sentence per reference — which image is the character, which is the set, what the video or audio is for — then write the scene: subject, one action, one camera move, light and sound. Supply images in the order you refer to them, because "Image 1" and "Image 2" are how the prompt points at them.

Change one thing per rerun

Hold seed and the reference set steady and change one line — the action, the camera move or a single reference — per attempt, so any difference in the result can be traced to that change. Explore at 5 seconds and 720p before committing to a longer or larger render, and check face, wardrobe, setting and voice against their references in every take.

API quick start

Call the Wan 3.0 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model alibaba/wan-3.0/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-3.0/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Wan 3.0 API questions

All Wan models

Wan 3.0 Pro renders the same kinds of shots at 1080p, 2K or 4K for a higher price. Plain Wan 3.0 is the better value for drafts and social clips.

• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Wan 3.0 Prime APIQuicker Wan 3.0 renders, up to 30 seconds with audioFrom 46 credits for a 5-second clip
• Wan 3.0 Pro Prime APIQuicker Wan 3.0 Pro with 2K and 4K outputFrom 176 credits for a 5-second clip
• Wan 3.0 Pro APIWan 3.0 at 1080p, 2K or 4K, up to 30 secondsFrom 108 credits for a 5-second clip
• Wan 2.7 Pro APILarge 4K canvases and nine-image compositesFrom 12 credits per image
• Wan 2.7 APIThinks through the composition, then draws up to four imagesFrom 5 credits per image
• Wan 2.6 Flash APIQuick multi-shot clips from a single imageFrom 17 credits for a 5-second clip
• Wan 2.6 APIMulti-shot sequences with sound at up to 1080pFrom 49 credits for a 5-second clip
• Wan 2.5 API1080p clips with sound that can follow your own audioFrom 34 credits for a 5-second clip
• Wan 2.2 Animate APIDrive a character photo with a reference videoFrom 7.95 credits per second
• Wan 2.2 LoRA APIWan 2.2 video with your LoRAs on either expert passFrom 18 credits for a 5-second clip
• Wan 2.2 APISimple five-second clips at 480p or 720pFrom 36 credits per run
• Wan 2.2 5B LoRA APILight 720p Wan 2.2 clips that load your own LoRAsFrom 18 credits per run
• Wan 2.2 Image LoRA APIWan 2.2 stills with up to nine LoRAs across three slotsFrom 5 credits per image
• Wan 2.1 LoRA APIWan 2.1 video and edits with your own LoRAs, camera moves includedFrom 36 credits per run
• Wan 2.1 Image LoRA APIPhotoreal Wan 2.1 stills and restyles with your LoRAsFrom 5 credits per image

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip

More about Wan 3.0

Try it

Wan 3.0 AI Video Generator onlineCreate videos with Wan 3.0 in PopNow

Compare

Kling 3.0 vs Wan 3.0Seedance 2.5 vs Wan 3.0

Docs

Wan 3.0 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Wan 3.0 results without polling