Wan 2.1 Image LoRA API

About Wan 2.1 Image LoRA

The Wan 2.1 Image LoRA API renders one frame from the Wan 2.1 video model, accepting the same Wan LoRAs as video endpoints. It is an efficient LoRA preview step: validate a style on stills, then send approved settings to alibaba/wan-2.1-lora for video.

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

Introduction

Choose a mode by starting material

Key features

Video LoRAs on stills

Wan 2.1 renders an image as a single frame, so Wan 2.1 14B text-to-video LoRAs apply here. In our example an origami LoRA turned a masked couple into folded-paper figures; without it, at the same seed, they stayed people.

Wan 2.2 style LoRAs

A single-file Wan 2.2 style LoRA turned a crisp colour photograph into warm brown film light on this model.

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 5 credits per image ($0.05).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Opening frames

Make the first frame here with the same LoRA, then animate it with Wan 2.1 LoRA image-to-video so the look stays consistent from still to clip.

Prompt guide & pro tips

Write like a photographer

Lens, light and colour words steer the look well: "50mm, shallow depth of field, warm lantern light" did more for our images than adjectives about quality.

Use 1.5k

Both sides are rounded down to a multiple of 32.

Trigger words first

Put a LoRA's trigger phrase at the start of the prompt. On stills some trigger words already push the style by themselves, so compare against a run without the LoRA.

API quick start

Call the Wan 2.1 Image 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-image-lora/text-to-image 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-image-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

# 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 Image LoRA API

• LoRA preview before expensive video renders.
• Opening-frame generation for Wan image to video.
• Photoreal still generation with custom styles.

Wan 2.1 Image LoRA parameter notes

• loras up to three Wan 2.1 (and single-file Wan 2.2) LoRAs as public direct links.
• resolution 1k or 1.5k at the same price.
• edit takes image_url and strength.
• seed and output_format supported.

How Wan 2.1 Image LoRA API pricing adds up

A flat price per image at both sizes, far below the cost of a video clip.

• Create Image: 5 credits ($0.05) per run, 500 credits ($5.00) for 100 runs

Async jobs, webhooks and rate limits

Every Wan 2.1 Image 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-image-lora/text-to-image never runs or bills twice.

Common Wan 2.1 Image LoRA API errors

Wan 2.1 Image LoRA API questions

All Wan models

Wan 2.1 LoRA animates the same LoRAs into 5 or 10 second 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 image APIs

• Qwen Image 2.1 LoRA APIQwen Image 2.1 images and edits with up to three of your LoRAsFrom 5 credits per image
• MiniMax H3 Image LoRA APIH3 stills and edits with up to three of your LoRAsFrom 7 credits per image
• Z-Image Base LoRA APIZ-Image Base with up to three of your own LoRAsFrom 3 credits per image
• Anima Turbo LoRA APIAnime art with your own style or character LoRAsFrom 3 credits per image

More about Wan 2.1 Image LoRA

Try it

Wan 2.1 Image LoRA AI Image Generator onlineCreate images with Wan 2.1 Image LoRA in PopNow

Endpoints

Wan 2.1 Image LoRA · Edit Image

Docs

Wan 2.1 Image LoRA model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Wan 2.1 Image LoRA results without polling