Wan 3.0 API

Introduction

Wan 3.0 Text to video generates a 2 to 30 second clip with sound from nothing but a written prompt. prompt is the only required field; duration_seconds, resolution (480p, 720p or 1080p, default 720p), aspect_ratio (default 16:9), generate_audio, enable_prompt_expansion and seed are optional controls you can leave at their defaults. Because no image anchors the shot, the model invents every face, garment and set from the words. That gives the widest creative range of the Wan 3.0 modes and the least control over a specific person.

Choose a Wan 3.0 mode by starting material

Key features

Sound written into the same request

generate_audio is on by default, so the returned file already carries sound locked to the picture. The armoury example uses this deliberately: its prompt ends with an "Audio:" line — a leather glove slapping onto wood, lacing creaking, a torch spitting — and those sounds come back with the actions that cause them. Set the field to false only when the shot will be scored separately.

Any whole length from 2 to 30 seconds

duration_seconds accepts every whole number from 2 to 30, with 5 as the default, or -1 for smart duration, where the model picks the length from the prompt. The dune example runs the default 5 seconds at 720p in 16:9 — enough for one aerial glide from the storm wall down to her face. Longer clips drift more in identity and geometry, so settle the look at 5 seconds before extending.

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

Atmospheric set pieces without a source image

When no photograph of the location exists, the prompt has to build it. The dune example describes a sunset dune crest, a colossal sandstorm rolling in, an emerald silk gown streaming in the wind and a camera that glides down from an aerial view to her face, all from the sentence alone. Requests like this suit mood films and pitch reels where the environment matters more than a specific face.

First-person framing

The point-of-view example is written as one continuous take: the camera is the viewer's own eyes, a single tungsten lamp is the only light, and the brief states that the wardrobe stays exactly as written throughout. Stating what stays unchanged is as useful as stating what moves, because it stops the model from resolving an ambiguous prompt in its own direction.

Prompt guide & pro tips

Order the prompt: subject, action, camera, light, sound

Write one subject, one action, one camera move, then a note each for light and sound. Long adjective lists move the result less than one clear action does.

Specify the framing when a detail carries the scene

The armoury prompt names its framing — medium close-up from the hips up, low three-quarter angle, 85mm — because a wide shot would lose the glove, the lacing and the torchlight on her shoulders. When a detail matters, say how large it should be in the frame instead of hoping the model picks a close shot.

Keep prompt expansion off for precise briefs

enable_prompt_expansion defaults to false here. Switching it on rewrites the prompt before generation, which helps a two-line idea and works against a detailed brief like the ones above. For controlled reruns, hold seed and change one field at a time; a fixed seed makes comparisons fair but does not guarantee identical frames. Text alone cannot keep one face across runs, so use reference-to-video for recurring characters.

API quick start

Call the Wan 3.0 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-3.0/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-3.0/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 3.0 API questions

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

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 3.0

Try it

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

Compare

Kling 3.0 vs Wan 3.0Seedance 2.5 vs Wan 3.0

Docs

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