Get API key

by Alibaba

Photoreal Wan 2.1 stills and restyles with your LoRAs

alibaba/wan-2.1-image-lora/text-to-imageFrom 5 creditsper image · $0.05
  • Up to 1.5K
  • 9 aspect ratios
  • Loads your own LoRA
  • Create Image
  • Edit Image
Origami gondola masksSee examples

About Wan 2.1 Image LoRA

Wan 2.1 Image LoRA uses Alibaba's open 14B video model to render single photorealistic frames, with up to three of your own Wan LoRA files per request. Text-to-image in nine aspect ratios up to 1536 pixels, plus image-to-image at one flat price per image.

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

What you haveMode
a written descriptionWan 2.1 Image LoRA Text to image
an image to changeWan 2.1 Image LoRA Image editing
a scene that should moveWan 2.1 LoRA Text to video

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

ParameterRequiredDescription
aspect_ratioNoThe shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Default: 1:1
lorasNoLoad your own LoRA files to lock in a style or character. Default: []
output_formatNoFile type of the result. jpeg · png · webp · Default: jpeg
promptYesDescribe the subject, the setting and the light. If a LoRA has trigger words, put them first.
resolutionNoOutput size. Bigger sizes look sharper and cost more. 1k · 1.5k · Default: 1k
seedNoReuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647

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.

OptionCredits per image≈ USD
Standard4.5$0.045

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.

Wan 2.1 Image LoRA API questions

How much does the Wan 2.1 Image LoRA API cost?

Wan 2.1 Image LoRA starts at 5 credits ($0.05) per image with Create Image, its cheapest task. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.

What is the model name for Wan 2.1 Image LoRA in the API?

Put alibaba/wan-2.1-image-lora/text-to-image for Create Image; alibaba/wan-2.1-image-lora/edit for Edit Image in the model field of POST /jobs/createTask.

Is this a video model?

Yes. Wan 2.1 is Alibaba's 14B video model; here it renders one frame per request, which makes it a photoreal image model that understands Wan LoRAs.

Which LoRAs work here?

Wan 2.1 14B text-to-video LoRAs, and in our test a Wan 2.2 single-file style LoRA as well. A LoRA for an unrelated model failed the request.

How does image editing work?

It redraws the source at the strength you choose and keeps its shape. Around 0.5 little changes; around 0.75 the outfit, the light and the setting follow the prompt, and so does the face.

Will the same seed give the same image?

Not reliably: in our test the same seed and prompt gave two different images. Use it to compare runs, not to reproduce one.

What are the limits of the Wan 2.1 Image LoRA API?

Resolutions: 1K · 1.5K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Prompt length (characters): 5,000. Requests outside these limits are rejected before anything is charged.

Can I try Wan 2.1 Image LoRA without writing code?

Yes. The Playground runs Wan 2.1 Image LoRA on your PopNow credits, needs no API key, and shows the matching code for every run.

All Wan models

Wan 2.1 LoRA animates the same LoRAs into 5 or 10 second clips.

More about Wan 2.1 Image LoRA