Wan 3.0 Prime API

Introduction

Wan 3.0 Prime Reference to video builds a 2 to 30 second shot on the Prime render from up to ten image, five video and five audio references, with the same fields as Wan 3.0 Reference to video. At least one reference array, a reference file or a web link must be present and the prompt is optional; when you write one, it should say what each reference controls. Resolution is 480p, 720p or 1080p, default 720p, and aspect_ratio defaults to 16:9.

Choose a Wan 3.0 Prime mode by starting material

Key features

One identity plate, a whole scene from text

A single plate can carry the person while the prompt invents everything else. The dune example uses one identity image shot flat on a plain studio background; the moonlit dune field, the wind and a scarf several metres long streaming above her are all written. The scarf still has to be attached to the same arm at the end of the take, which makes it a good thing to check.

Camera behaviour borrowed from a clip

Reference video is for movement and camera style rather than faces. The motion-style example takes a slow handheld orbit from a reference clip and applies it to the woman from a reference image, standing in an empty studio, for 6 seconds at 720p. Reference clips must be MP4 or MOV, at least 16 fps, 1 to 15 seconds each and 15 seconds in total.

Voice continuity from audio references

Up to five WAV or MP3 audio references, 15 seconds in total, can hold a voice across takes. A presenter who looks continuous but sounds different between shots is still discontinuous, so when a person speaks in more than one shot, send the same audio reference every time.

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

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

Use cases

A recurring presenter

Keep the same image plates for face and set, and the same audio reference for the voice, in every request of a series. The presenter example keeps "the same presenter, the same studio" and describes only the move — a push that ends on a specific framing — because identity is already carried by the references.

Style-matched inserts

When a new shot has to move the way an existing one does, supply that clip as a motion reference and an image for the subject. State in the prompt which is which, as the motion-style example does: "Take the camera behaviour from the reference clip — a slow handheld orbit — and apply it to the woman in the reference image."

Prompt guide & pro tips

Budget reference video against output length

A 6-second style clip therefore leaves room for up to 24 seconds of output. Reference limits are enforced during generation rather than on submission, so trim clips before you send them.

Keep the face on an image, not a video

A reference video sets motion style well but is a poor way to pin a face. Put identity on an image plate, name it in the prompt, and use video only for how the camera or the body moves.

Hold the reference set steady between takes

Change one reference or one line of the prompt per attempt and hold seed, so a difference can be traced to its cause. Settle the look at 5 seconds and 720p before extending, and check face, costume and voice against their references at the start and end of every render.

API quick start

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

All Wan models

Plain Wan 3.0 makes the same clips for less when you can wait a little longer.

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

Try it

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

Docs

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