Wan 3.0 Pro API

Introduction

Wan 3.0 Pro Reference to video holds a face, a garment, a set, a movement or a voice across shots using image, video and audio references, and delivers the result at 1080p, 2K or 4K for 2 to 30 seconds. Send at least one of reference_image_urls (1 to 10 ordered images), reference_video_urls, reference_audio_urls (up to 5 clips each), reference_file_url (one document) or reference_link_url (one web page). The prompt is optional, but it is where each reference gets its job and where the action is stated.

Choose a Wan 3.0 Pro mode by starting material

Key features

One master, several crops

A reference-locked shot rendered at 4K gives a master that can be cropped for a banner and a vertical cutdown. The garment example sends one coat plate — "Keep the coat from the reference exactly — cut, colour and stitching" — and renders 6 seconds at 4k with audio off while the model turns once on a dark stage and the hem lifts and settles.

Drift is easier to see at delivery size

A face that shifts between shots is immediately obvious at high resolution, which helps in review: render each shot of a sequence at the delivery size and compare them side by side before committing. The 2k and 4k tiers are enlarged from a native 1080p render, so they reveal inconsistencies from the render rather than hiding them.

Reference budgets

Video and audio references are each capped at 15 seconds in total, with every clip between 1 and 15 seconds, and reference video plus duration_seconds must stay within 30 seconds. These limits are enforced during generation, not at submission, so check clip lengths first.

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.

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

Use cases

Episodic shots with a labelled face and set

The face-and-set example sends two plates and one action line: "The first image is the character — keep her face, hair and the black gown. The second image is the room." She walks from the doorway to the window under a slow lateral track, 8 seconds at 1080p with seed 640117. Reuse the plates and the seed for every shot of an episode and change only the action.

Same people, different light

The three-times-of-day example keeps two people and one apartment while the light changes: morning across the sheets, dusk on the kitchen counter, night on the balcony. That is the awkward continuity case, because everything except the light must hold. The references carry the people and the room, so the prompt describes only what differs.

Prompt guide & pro tips

Label references in order

reference_image_urls is ordered, so refer to images as "the first image" and "the second image" and supply them in that order. For each one, say whether it is a character, a garment or a set. Use reference videos for movement and camera style rather than faces, and audio for a voice, a line reading or room tone.

Turn prompt expansion off for the final render

enable_prompt_expansion is true by default on this family and rewrites detailed briefs, which can blur the roles you assigned. Switch it off once the reference labels and action line are settled, keep seed fixed, and do the first renders at 1080p and 5 seconds.

Scale up only the approved take

When the shot works at 1080p, re-send the identical body with resolution set to 2k or 4k. Keep aspect_ratio on adaptive unless the delivery frame is fixed, and check the recurring details — face, cut of the garment, room layout — at the start and end of the delivered file.

API quick start

Call the Wan 3.0 Pro 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-pro/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-pro/reference-to-video",
  "input": {
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "resolution": "1080p",
    "aspect_ratio": "adaptive",
    "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 Pro API questions

All Wan models

Wan 3.0 renders natively at 480p, 720p or 1080p for much less. Choose Pro only when the deliverable needs 2K or 4K.

• 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 Pro

Try it

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

Docs

Wan 3.0 Pro 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 Pro results without polling