Wan 2.1 LoRA API

About Wan 2.1 LoRA

The Wan 2.1 LoRA API exposes more sampler control than most endpoints: steps, guidance_scale and flow_shift alongside a loras array, on text, image and video to video. Billing is per clip by resolution, which keeps restyle jobs predictable. It suits creator tools that want LoRA-based restyling of user footage.

Call it with the model name alibaba/wan-2.1-lora/text-to-video on POST /jobs/createTask, from 36 credits per run ($0.36). New accounts get 30 free credits to try it in the Playground first.

Introduction

Wan 2.1 LoRA Text to video generates a silent clip from a prompt with up to three of your LoRA files loaded on Alibaba's open 14B video model.

Choose a mode by starting material

Key features

A deep community LoRA library

Load up to three by direct link, each with its own strength from 0 to 4.

Wan 2.2 LoRAs carry over

In our test a single-file Wan 2.2 style LoRA turned the clip into a sepia old-film look on this model, so a good part of the newer Wan 2.2 library is usable here as well. A LoRA for an unrelated model, such as an image model, fails the request instead.

Tuning left open

Steps, guidance, flow shift and a negative prompt are all yours to set, which matters for LoRAs whose authors publish recommended settings. The defaults (30 steps, guidance 5) gave clean frames in our runs.

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

Character series

Train or download a character LoRA once and load it on every request: the same face and outfit carry across scenes, which a prompt alone cannot guarantee from clip to clip.

Styled shorts

A style LoRA gives every clip in a set the same look, from cel animation to vintage film, so a series reads as one piece even when the prompts change.

Prompt guide & pro tips

Trigger words first

Most Wan LoRAs were trained with a trigger phrase, listed on the LoRA page. Put it at the very start of the prompt, then describe the subject, the action and the camera in plain sentences.

Start at scale 1

In our tests 0.5 already moved the result and 1 moved it further. Raise the scale only if the LoRA still looks faint, and lower it if the set and the characters change more than you want.

Use direct, public links

Use a public link that downloads the .safetensors file itself, such as a Hugging Face "resolve/main" link.

API quick start

Call the Wan 2.1 LoRA 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.1-lora/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.1-lora/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "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.

What to build with the Wan 2.1 LoRA API

• Footage restyling: live action to animation via video-edit and a style LoRA.
• Camera-move presets on photos using orbit and dolly LoRAs.
• Seeded LoRA comparisons for training pipelines.

Wan 2.1 LoRA parameter notes

• loras takes up to three entries; Wan 2.1 14B LoRAs, many Wan 2.2 style LoRAs also load.
• steps, guidance_scale and flow_shift tune sampling; defaults are sensible.
• video-edit takes strength (0.1 to 1) for how far the restyle departs from the source.
• Output is silent, 5 or 10 seconds, 480p or 720p.

How Wan 2.1 LoRA API pricing adds up

Billed per clip by resolution on all three endpoints, with 720p at one and a half times 480p. On video to video, choosing 10 seconds bills the 10 second rate even if the source is shorter.

• duration_seconds 5 · resolution 480p: 36 credits ($0.36) per run, 3600 credits ($36.00) for 100 runs
• duration_seconds 10 · resolution 720p: 81 credits ($0.81) per run, 8100 credits ($81.00) for 100 runs

Async jobs, webhooks and rate limits

Every Wan 2.1 LoRA request is asynchronous: createTask returns a taskId straight away, and the result arrives when the job finishes. Poll GET /jobs/recordInfo every few seconds, or pass a public https callBackUrl and verify the X-Webhook-Signature header (HMAC-SHA256 over taskId, timestamp and the body hash) before trusting the payload. Each account gets 1,000 write requests per 10 seconds; a 429 carries Retry-After. Send an Idempotency-Key with createTask so a retried request for alibaba/wan-2.1-lora/text-to-video never runs or bills twice.

Common Wan 2.1 LoRA API errors

Wan 2.1 LoRA API questions

All Wan models

Wan 2.2 LoRA runs the newer model with separate motion and detail slots.

• 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
• LTX-2.3 LoRA APILTX-2.3 clips with stereo sound and your own LoRAsFrom 18 credits for a 5-second clip
• LTX-2 19B LoRA APILTX-2 clips with sound and your own LoRA stylesFrom 14 credits for a 5-second clip
• MiniMax H3 Singularity LoRA APICommunity-tuned H3 video that loads your own LoRAsFrom 45 credits for a 5-second clip

More about Wan 2.1 LoRA

Try it

Wan 2.1 LoRA AI Video Generator onlineCreate videos with Wan 2.1 LoRA in PopNow

Endpoints

Wan 2.1 LoRA · Image to VideoWan 2.1 LoRA · Edit Video

Docs

Wan 2.1 LoRA 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.1 LoRA results without polling