Wan 2.2 API

Introduction

Wan 2.2 Image to video starts from a picture you supply and animates what happens next. Two inputs are required: an opening frame in JPEG, PNG or WebP of up to 10 MB, and a prompt of up to 5,000 characters that describes the motion. Each request returns one silent five-second clip at 480p, the default, or 720p.

Choose a Wan 2.2 mode by starting material

Key features

The frame carries the appearance

Subject, wardrobe, set and light direction all come from the opening image, so the prompt does not have to describe them again. That makes this mode the right one for material that has to match: in the serum-bottle example the frame fixes the label and silhouette, and the prompt asks only for a camera arc and moving light.

The shape comes from the image

There is no aspect-ratio setting on this endpoint. 16:9 and 9:16 are the safest proportions, because a frame in other proportions can come back resized and centre-cropped. Crop the image to the delivery shape before you upload it.

Fixed length, picture only

Every take is five seconds of video without sound, and neither length nor audio can be changed. With those fixed, motion is the only variable, which is why each published example asks for a single movement or a single cause and effect.

Prompt expansion changes more than the wording

Prompt expansion is off by default. Switching it on can change the look of the render, not only the text of the brief, so compare against a run with it off before you keep it. The chime-and-the-figure example leaves it off so that its sentence runs exactly as written.

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

Moving a product still

Send an approved packshot and ask for a camera move or a change in light while the product stays where it is. The serum-bottle example shows the pattern: the camera arcs a slow quarter turn around a dropper bottle, a soft band of window light slides across the glass, and the prompt states that the bottle itself does not move.

One performance beat from a portrait

The slip-dress example starts from a studio portrait and asks for a single piece of action: she shifts her weight, turns her shoulders toward the lens, takes two slow steps and holds the look. The camera is locked, the grey studio backdrop is left untouched, and the take is rendered at 720p.

Motion with a visible cause

In the chime-and-the-figure example a wind chime turns and a shape behind a gauze curtain shifts with it, the curtain's shadow travelling across the scene. Writing cause and effect into a short silent clip gives the movement a reason and keeps it from reading as a loop.

Prompt guide & pro tips

Prepare the frame before the prompt

Crop the image to 16:9 or 9:16 and check that it already shows the wardrobe, set and light you want, because the prompt is not the place to change them. Remove overlays or stray subjects you do not want animated, and keep the file within 10 MB.

Describe only what happens after the frame

State who or what moves, the direction and pace of that movement, and then the camera behaviour. Redescribing objects that are already visible spends characters without adding motion. A line that says what must stay still, such as the bottle that does not move, is worth including.

Draft at 480p, deliver at 720p

Fix a seed between 0 and 2147483647 when you compare a 480p draft with its 720p rerender from the same frame. For a random draw, leave the seed out rather than sending 0.

Review the whole clip before you expand the action

Watch the opening, the largest movement and the final second. If a face, label or outline drifts, cut the number of simultaneous movements before you rewrite the prompt. When the next shot needs a different composition, start from a new frame instead of asking the motion to reach it.

API quick start

Call the Wan 2.2 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-2.2/image-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-2.2/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": "480p"
  }
}'

# 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 2.2 API questions

All Wan models

Wan 2.5 adds sound, 1080p and 10-second clips, and starts at about the same price.

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

Try it

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

Docs

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