Wan 3.0 Pro Prime API

Introduction

Wan 3.0 Pro Prime Reference to video locks a face, a garment, a set, a movement or a voice with image, video and audio references and renders the shot at 1080p, 2K or 4K for 2 to 30 seconds on the Prime render. 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) is required. Name each reference in the prompt, or the model averages them into a subject that matches none of them.

Choose a Wan 3.0 Pro Prime mode by starting material

Key features

Two characters in one shot

The two-character example sends two plates and labels them: "The first image is the woman, the second is the man — keep both faces and both haircuts." They stand on either side of a workbench in a dim garage under one hanging bulb, 6 seconds at 1080p with seed 220913 and room tone only. It is the pattern for keeping a couple consistent across an episode.

A set plate with no people

References do not have to be people. The set-continuity example sends one plate of a boxing gym — ropes, lockers, a single hanging light — and asks for an empty frame with dust drifting through the beam and the bulb swinging slowly, locked camera, 5 seconds at 4k with audio off. Every shot in a sequence can then share the same room.

Movement referenced instead of written

Image, video and audio references can go in together, so movement can come from a clip rather than a paragraph.

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 176 credits for a 5-second clip ($1.76).

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

Use cases

A costume across several stages

The dancer example carries one performer and one layered chiffon costume into a third stage, with the follow spot now behind her so the fabric goes translucent as she turns through it. The references carry the dancer and the garment, so the prompt describes only the new lighting set-up, and translucent fabric under backlight leaves almost nothing to hide behind at a large delivery size.

Master files that get recut

Render a reference-locked hero shot at 4K in 16:9, then crop a 9:16 cutdown and a square banner out of the same master. Reference plates plus a fixed seed keep the cast identical across every derivative in the set.

Prompt guide & pro tips

Label by position

reference_image_urls is an ordered list, so refer to "the first image" and "the second image" and supply them in that order. Say for each one whether it is a character, a garment or a set; use video for movement and camera style and audio for a voice, a line reading or room tone.

Hold everything except the change

For a sequence, keep the plates, the seed and the prompt skeleton identical and change only the action or lighting line. Turn enable_prompt_expansion off — it defaults to true on this family — so the labels you wrote are not rewritten.

Check reference lengths before you submit

Video and audio reference limits are enforced during generation rather than when the task is accepted, so a clip over the limit is caught later instead of at submission. Measure clips first, keep reference video plus duration_seconds at 30 seconds or less, and explore at 1080p before rendering at 4K.

API quick start

Call the Wan 3.0 Pro Prime 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-prime/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-prime/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 Prime API questions

All Wan models

Wan 3.0 Pro offers the same sizes from the standard Wan 3.0 render, for less per second. Pro Prime is the faster of the two.

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

Try it

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

Docs

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