Wan 2.5 API

Introduction

Wan 2.5 Text to video generates a 5- or 10-second clip with sound from a written prompt alone. prompt is the only required field, up to 1,500 characters; everything else has a default: 16:9, 720p, five seconds, prompt expansion off. Use it when no approved still exists yet and the setting, action and camera all have to come from the text. When you already have the opening frame, the image-led endpoint keeps that frame's subject and proportions instead.

Choose a Wan 2.5 mode by starting material

Key features

Picture and sound in one pass

The clip comes back with audio already in the file: ambience, effects and voices are generated alongside the picture, so a closing line such as "Audio: gulls, a splash, her breath" is worth writing. To make movement and mouth shapes follow a take you already have, pass audio_url, a WAV or MP3 of 3 to 30 seconds and up to 15 MB. A track longer than the clip is cut at the end; a shorter one leaves the rest of the clip silent.

Five shapes, three resolutions, two lengths

aspect_ratio accepts 16:9, 9:16, 1:1, 4:3 and 3:4, and resolution accepts 480p, 720p and 1080p. The two interact: at 480p only landscape, portrait and square frames render, so 4:3 and 3:4 need 720p or above. duration_seconds is exactly 5 or 10, and a value such as 7 is rejected rather than rounded. Resolution also sets the per-second rate and how long the task takes to return.

Exclusions and controlled comparisons

negative_prompt holds up to 500 characters and is where captions, logos, extra people or a recurring colour belong. seed (0 to 2147483647) keeps the random source steady while you change one field at a time, without promising an identical frame. enable_prompt_expansion is off by default; switched on, it rewrites a short brief into a fuller one before generation.

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

Vertical clips with the soundtrack inside

Set aspect_ratio to 9:16 and keep five seconds for a feed draft that needs no separate audio pass. The published record-shop example goes further: ten seconds at 1080p in 9:16, a slow tilt from a crate of vinyl up to the man's face, and a negative prompt of "text on screen, logos, extra people" so no captions or passers-by appear.

Checking sound against a visible action

The saxophone example asks for ten seconds at 1080p in 16:9, with the horn's sound matching the fingering. Tying the audio to something you can see (keys, a splash, a turntable crackle) gives you a concrete check on playback instead of judging ambience alone.

A spoken line on your own timing

Record the line, pass it as audio_url, and describe who is speaking and where. Movement and mouth shapes follow the file's timing, so the review can focus on the performance. When the speaker has to be a specific face or product, text alone will not hold that likeness between runs; start from a still on the image-to-video endpoint.

Prompt guide & pro tips

Write the shot in a fixed order

Subject, one action, one camera move, light, then a line about sound. A clear verb changes the result more than a stack of adjectives. Keep exclusions out of the prompt and list them in negative_prompt, and leave enable_prompt_expansion off once your prompt is already a precise shot description, so the wording is used as written.

Adapt the included example

The published harbour example runs at aspect_ratio 16:9, duration_seconds 5 and resolution 720p. Keep its structure when you swap in your own subject and location.

One action and one camera position, with the sound written out so the splash and laugh land on the right frames.

Iterate at five seconds and 720p

Fix seed and compare one change at a time: the verb, the camera move, the sound line. When the take works, rerender it at 10 seconds or at 1080p. If a 4:3 or 3:4 request is rejected, check the resolution first, because those shapes are not available at 480p.

Review the whole clip with sound on

Play the clip from start to finish with audio: does the action read at normal speed, do effects land on their visible source, and do hands and hair hold together? Longer clips drift more in hands, hair and fine detail, so compare a 10-second take against the 5-second version 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/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.5/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "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 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