Wan 2.5 API

Introduction

Wan 2.5 Image to video turns the still you send in image_url into a 5- or 10-second clip with sound. The image decides subject, wardrobe, set, light direction and the clip's proportions; the optional prompt, up to 1,500 characters, describes what happens after it. There is no aspect-ratio field on this endpoint, so crop the image to the delivery shape before sending it. With only a written idea and no still, use the text-led endpoint instead.

Choose a Wan 2.5 mode by starting material

Key features

The opening frame carries the look

image_url accepts JPEG, PNG, BMP or WebP up to 20 MB, with each side between 240 and 8,000 pixels. Anything already visible in that file, such as a label, a silhouette or a costume, does not need describing again, so the prompt can spend its words on motion, camera and sound.

Audio generated with the picture, or timed to your track

Every clip returns with sound generated alongside the picture. Add audio_url, a WAV or MP3 of 3 to 30 seconds and up to 15 MB, when a recorded line or music cue should set the timing: the face comes from the frame and the mouth timing from the audio. A track longer than the clip is cut at the end; a shorter one leaves the remainder silent.

Two lengths and three resolutions

duration_seconds is exactly 5 or 10, and resolution is 480p, 720p (the default) or 1080p. Short clips hold hands and hair better, so settle the motion at five seconds before committing to ten.

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 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 motion from one packshot

The published serum-bottle example sends a product still and asks only for a slow quarter-turn camera arc while a band of window light slides across the glass; the bottle itself does not move. Because the frame already fixes label and silhouette, the prompt carries only light and motion, rendered at 720p for five seconds.

A portrait that speaks a recorded line

Send an approved portrait as image_url and the voice line as audio_url. The person's appearance comes from the image and the mouth timing from the file, so the review is about delivery rather than lip sync.

A longer studio take with guarded details

The slip-dress example runs ten seconds at 1080p from a studio portrait: a weight shift, a turn toward the lens and two slow steps under a locked camera. Its negative prompt, "extra people, text, jewellery changes", stops accessories from changing and extra figures from appearing over the longer duration.

Rain, water and other sound with a visible source

In the umbrella example, two figures stay nearly still while rain drums on the umbrella above them, so the motion belongs to the water and the sound has a source you can see. When the event is continuous like this, five seconds is usually enough.

Prompt guide & pro tips

Prepare the frame first

Crop to the delivery shape and check that the image already shows the wardrobe, set and light you want. The clip keeps the image's proportions and inherits its look, so a mistake in the still carries straight into the video.

Describe only the motion

The prompt is optional, but one clear action line gives far steadier motion. Write one action, one camera behaviour and a note on sound. Put anything the frame keeps bringing back, such as a second person, captions or a prop, into negative_prompt. Turn enable_prompt_expansion on for a one-line idea and leave it off when the prompt is already a precise action.

Adapt the included example

Start from the published example at duration_seconds 5 and resolution 720p, with your own publicly accessible image in image_url.

The camera arcs a slow quarter turn around the dropper bottle while a soft band of window light slides across the glass and the liquid inside catches it. The bottle itself does not move. Quiet room tone, no music.

The frame fixes the label and silhouette; the prompt asks only for a camera arc and moving light.

Compare takes with a fixed seed

Fix seed when comparing resolution or length from the same frame, and change one field per run. For a random draw, leave the field out rather than sending 0. Play the full clip with sound before delivery.

API quick start

Call the Wan 2.5 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.5/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.5/image-to-video",
  "input": {
    "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 2.5 API questions

All Wan models

Wan 2.6 adds multi-shot clips and reference scenes; Wan 3.0 runs up to 30 seconds.

• 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.5

Try it

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

Docs

Wan 2.5 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.5 results without polling