Wan 2.2 API

Introduction

Wan 2.2 Text to video generates a clip from a written prompt alone. Each request returns one silent five-second video in 16:9 or 9:16, rendered at 480p or 720p. The prompt can run to 5,000 characters and is the only required field: the aspect ratio defaults to 16:9, the resolution to 480p, and prompt expansion stays off unless you switch it on.

Choose a Wan 2.2 mode by starting material

Key features

A fixed five-second take

Text to video has no duration setting: every take is exactly five seconds, so the length of a request is known before you send it. Five seconds holds one beat (a subject, one action and one camera move) rather than a sequence of events, and prompts work best when they are written to that size.

Two shapes and two resolutions

The aspect ratio is 16:9 by default or 9:16 for vertical delivery. Square and 4:3 frames are not offered, so render at 16:9 and crop in the edit when a square cut is needed.

Picture only

Clips come back without an audio track and there is no audio control. Anything the viewer should feel has to be visible: the published snow-platform example builds its rhythm from falling snow, breath clouding in the cold and a flickering platform lamp instead of relying on ambience.

Optional prompt expansion and seed

Prompt expansion rewrites a short brief into a fuller one before generation. The seed accepts 0 to 2147483647 and keeps the random source fixed so you can compare one change at a time; it does not promise a frame-identical clip on a second run.

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

Storyboard drafts in bulk

Write each storyboard beat as its own prompt and render the whole list at 480p. Rerender the takes you keep at 720p with the same prompt and seed.

Vertical clips for social feeds

Set the aspect ratio to 9:16 and describe one continuous action. The published night-market example does exactly that at 720p: a young woman in a yellow raincoat takes a skewer from a grill stall, smoke and steam rise through strings of bulbs, and she turns to walk toward the camera while it makes a slow handheld push-in.

Checking whether a shot idea moves

The lighthouse-stairs example is written as one action and one camera position, an older man with a lantern climbing the last turn of a spiral staircase while a low camera follows, and rendered in 16:9 at 480p.

Prompt guide & pro tips

Write one beat in a fixed order

Name the subject, the single action, one camera move and then the light. A clear verb moves the result more than a stack of adjectives: a man who climbs the last turn of a staircase and stops at a window gives the clip a start and an end inside five seconds.

Spend the character limit on detail, not on extra scenes

The 5,000-character limit leaves room for wardrobe, set, weather and light, but five seconds will not carry a second event. When a brief contains several events, split them into separate requests and cut them together in the edit.

Hold the seed while you revise

Pick a seed and keep it while you change one thing, such as a verb, the camera move or the aspect ratio. The night-market example fixes seed 250728 so that the same framing can be compared across prompt edits. Leave the seed out when you want variety instead.

Decide on prompt expansion early

For a one-line idea, switching prompt expansion on lets the service write a fuller brief for you. Once the prompt already names subject, action, camera and light, leave it off so the text runs as written, and judge any expanded run against one without it.

Know when text is not enough

A prompt alone will not hold a specific face or product steady from one run to the next. When the subject has to match an approved still, switch to Wan 2.2 Image to video and let the frame carry the appearance.

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/text-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/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "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