Introduction
Wan 3.0 Image to video animates a still you supply. image_url is used exactly as the first frame, so wardrobe, body, set and light direction come from the picture and the prompt only has to describe motion. The prompt is optional; without it the model animates the frame on its own. An optional last_image_url fixes the exact final frame. Clips run 2 to 30 seconds at 480p, 720p or 1080p, with generated sound on by default. It is the most literal of the modes: when the output has to match your wording, put the look in the image and spend the prompt on movement.
Choose a Wan 3.0 mode by starting material
| What you have at the start | Mode |
|---|---|
| a written scene or script | Wan 3.0 Text to video |
| an approved opening image | Wan 3.0 Image to video |
| separate visual, motion, or sound references | Wan 3.0 Reference to video |
Key features
The opening frame sets the quality ceiling
Because the first frame is your image, its sharpness, lighting and composition are the upper limit of the clip. Sources can be JPEG, PNG without transparency, BMP or WEBP, 240 to 8000 pixels per side, no wider than 8:1 and at most 20 MB. Leave aspect_ratio out and the clip inherits the frame's shape; a conflicting ratio crops it.
A landing frame that is pinned, not suggested
last_image_url is not loose guidance: the clip ends exactly on that image, and it only works together with image_url. The bottle example passes the same packshot as both frames, so the bottle turns a quarter circle, lets a highlight travel across the glass and lands back on its starting angle with the label readable.
Long spans between two fixed moments
With both ends supplied, only the passage between them is generated. The rooftop example pins an open dance hold as the first frame and the bottom of a dip as the last, and the model fills the five seconds between them at 720p; the same two stills can bracket a much longer move, because duration_seconds reaches 30 on this endpoint.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive |
duration_seconds | No | How long the clip runs. You pay per second. -1–30 · Default: 5 |
enable_prompt_expansion | No | Lets the model add detail to a short prompt. Default: false |
enable_thinking | No | Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Default: false |
generate_audio | No | Adds sound made to match the picture: voices, ambience and effects. Default: true |
image_url | Yes | The picture to start from. |
last_image_url | No | Optional final frame, so the clip ends exactly where you want. |
prompt | No | Describe the subject, action, camera, light, pacing, and boundaries for the shot. |
resolution | No | Output size. Bigger sizes look sharper and cost more. 480p · 720p · 1080p · Default: 720p |
seed | No | Reuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647 |
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.
| Option | Credits per second | ≈ USD |
|---|---|---|
| resolution 480p | 6.75 | $0.068 |
| resolution 720p | 13.5 | $0.14 |
| resolution 1080p | 27 | $0.27 |
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
Product turns that return to the hero angle
For packshots, supply the approved image as both first and last frame, lock the camera and describe a single movement. The bottle example uses one soft key from the left, no music (generate_audio set to false) and a fixed seed of 20260907, which makes it easy to rerun the same move after a small wording change and compare the two files.
Styled shots that follow the wording
When a garment, body or set has to appear exactly as approved, put it in the opening frame.
Prompt guide & pro tips
Describe what changes, not what is visible
Everything already in the frame is inherited, so redescribing it spends words that the motion needs. Say who or what moves, in which direction and how fast, then what the camera does: "The bottle rotates a quarter turn so the highlight travels across the glass, then returns to its starting angle. Locked camera, single soft key from the left, no music."
Prepare both frames as a matched pair
When you add last_image_url, make both images at the same crop and from the same set, and let the prompt explain how one becomes the other. The rooftop example pairs an opening frame of a couple in an open dance hold with a closing frame of the same couple, on the same rooftop and from the same camera position, at the bottom of a dip, and the prompt describes only the movement between them: he draws her in by the hand and lowers her into the dip while the camera stays locked.
Check the middle of the clip, not only the ends
A matching final frame does not prove a believable transition. Review the opening, middle and final moments for identity and geometry; if they drift, reduce the number of simultaneous movements before extending the duration. Settle the motion at 5 seconds, then lengthen, and keep enable_prompt_expansion at its default false so a detailed motion brief runs as written.
API quick start
Call the Wan 3.0 API in three steps
- 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.
- Send the request. POST /jobs/createTask with model alibaba/wan-3.0/image-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
- 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/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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
How much does the Wan 3.0 API cost?
Wan 3.0 starts at 34 credits ($0.34) for a 5-second clip with Image to Video, its cheapest task. Prices by option: 480p 6.75 credits per second, 720p 13.5 credits per second, 1080p 27 credits per second. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.
What is the model name for Wan 3.0 in the API?
Put alibaba/wan-3.0/text-to-video for Create Video; alibaba/wan-3.0/image-to-video for Image to Video; alibaba/wan-3.0/reference-to-video for Reference to Video; alibaba/wan-3.0/video-extend for Extend Video in the model field of POST /jobs/createTask.
How long can a Wan 3.0 clip be?
Two to thirty seconds, set with duration_seconds as a whole number. The default is five. Longer clips drift more in identity and geometry, so settle the shot at five seconds first.
Does Wan 3.0 generate audio?
Yes, and it is on by default. Picture and sound come back in one file, already aligned. Set generate_audio to false when you plan to add your own score.
What resolutions does Wan 3.0 support?
480p, 720p and 1080p, defaulting to 720p. If you need 2K or 4K, use Wan 3.0 Pro instead — it publishes a different resolution ladder.
Can I set the first and last frame?
On image-to-video, yes. image_url is the opening frame and last_image_url is optional; supplying both pins where the move starts and where it lands, which is what keeps product geometry readable.
How many reference images does reference-to-video take?
Up to ten images, plus up to five reference videos and five reference audio files. Reference videos are limited to fifteen seconds in total, and so are reference audio files; at least one of the three arrays, a reference file or a web link has to be present, while the prompt is optional.
What are the limits of the Wan 3.0 API?
Clip length: 2–30 s; Resolutions: 480p · 720p · 1080p; Aspect ratios: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive. Requests outside these limits are rejected before anything is charged.
Can I try Wan 3.0 without writing code?
Yes. The Playground runs Wan 3.0 on your PopNow credits, needs no API key, and shows the matching code for every run.
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

