Introduction
Qwen Image 2.1 LoRA Text to Image runs Alibaba's newest open-weight image model with your own LoRA weights loaded on top — up to three files per request, each with its own strength.
A LoRA here is a URL, not an upload.
Choose a Qwen Image 2.1 LoRA mode by starting material
| Starting material | Mode |
|---|---|
| A brief plus your own weights | Qwen Image 2.1 LoRA Text to Image |
| Source images plus your own weights | Qwen Image 2.1 LoRA Editing |
| No custom weights needed | Qwen Image 2.1 |
Key features
No upload, no allow-list, no approval queue
Most hosted APIs that accept custom weights want them uploaded, reviewed, or picked from a curated list — which excludes exactly the weights most people want to run. Here you supply a direct link to a .safetensors file or a Hugging Face repository and a strength, and it is fetched when the request runs.
Three slots, independent strengths
Three entries per call, each with its own scale from 0 to 4, covers the stack production work actually uses: a character LoRA holding the person, a house-style LoRA at a lower weight colouring the frame, a detail LoRA for skin or fabric. Change one scale per run — moving two at once leaves you unable to attribute the result.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The 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 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 · Default: 1:1 |
loras | No | Load your own LoRA files to lock in a style or character. Default: [] |
output_format | No | File type of the result. jpeg · png · webp · Default: jpeg |
prompt | Yes | Describe the subject, composition, lighting, and any wording to render. |
resolution | No | Output size. Bigger sizes look sharper and cost more. 1k · 1.5k · 2k · Default: 1k |
seed | No | Reuse 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.
| Option | Credits per image | ≈ USD |
|---|---|---|
| resolution 1K | 4.5 | $0.045 |
| resolution 1.5K | 8.1 | $0.081 |
| resolution 2K | 15.3 | $0.15 |
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
Consistent characters at scale
A character LoRA holds a face and body across hundreds of frames far more reliably than seeds or reference chaining.
House style over a general model
A style LoRA trained on your own catalogue makes output look like yours rather than like a generic render.
Production stacks
Character, style and detail weights together in one request, each at its own strength.
Prompt guide & pro tips
Let the weights do their job
Describe the scene, not the thing the LoRA already knows. Restating a character's features when a character LoRA is loaded tends to fight it rather than reinforce it.
Start at 1, then move one value
Scale 1 is neutral. Drop to 0.4-0.6 when a weight overwhelms the prompt; push past 1 when it has to survive a busy scene. One change per run.
Budget for the first call
The weights are fetched before generation. A 1.2 GB file added around 25 seconds to that request in our testing. Later calls with the same file are faster.
Check a new LoRA actually does something
Weights for a different base architecture can load without an error and barely affect the image. Run one obvious test prompt before committing a batch.
API quick start
Call the Qwen Image 2.1 LoRA API in three steps
- 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.
- Send the request. POST /jobs/createTask with model alibaba/qwen-image-2.1-lora/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
- 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/qwen-image-2.1-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.
Qwen Image 2.1 LoRA API questions
How much does the Qwen Image 2.1 LoRA API cost?
Qwen Image 2.1 LoRA starts at 5 credits ($0.05) per image with Create Image, its cheapest task. Prices by option: 1K 4.5 credits per image, 1.5K 8.1 credits per image, 2K 15.3 credits per image. 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 Qwen Image 2.1 LoRA in the API?
Put alibaba/qwen-image-2.1-lora/text-to-image for Create Image; alibaba/qwen-image-2.1-lora/edit for Edit Image in the model field of POST /jobs/createTask.
How do I supply a LoRA?
As an entry in the loras array: a path, which is a direct HTTPS URL to a .safetensors file or a Hugging Face repository, and a scale from 0 to 4. Nothing is uploaded to us; the file is fetched when the request runs.
How many LoRAs can I stack?
Three per request, each with its own strength. A fourth entry is rejected before generation starts.
What does scale actually do?
It weights how strongly the LoRA overrides the base model. 1 is neutral, below 1 softens its influence, above 1 lets it dominate. When stacking, move one value at a time or you will not know which weight caused a change.
Can I combine a LoRA with a marked-region edit?
Yes. Mark the region on the reference image and describe the change inside it as usual. Keep in mind the LoRA is not scoped to that region — at a high scale a style LoRA will influence the whole frame, so drop it toward 0.4-0.6 when you want the edit to stay local.
Why did my LoRA seem to do nothing?
Most often the weights were trained for a different base architecture. They can load without an error and still barely affect the image. Run one obvious test prompt against a known-good LoRA before committing a batch.
What are the limits of the Qwen Image 2.1 LoRA API?
Resolutions: 1K · 1.5K · 2K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Prompt length (characters): 5,000. Requests outside these limits are rejected before anything is charged.
Can I try Qwen Image 2.1 LoRA without writing code?
Yes. The Playground runs Qwen Image 2.1 LoRA on your PopNow credits, needs no API key, and shows the matching code for every run.
All Qwen Image models
Plain Qwen Image 2.1 is cheaper when you don't need your own weights.
- Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
- Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image
- Qwen Image 2.1 APIOpen model with 2K output and transparent backgroundsFrom 4 credits per image
- Qwen Image 2.1 LoRA APIQwen Image 2.1 images and edits with up to three of your LoRAsFrom 5 credits per image
- Qwen Image 3.0 Pro APIFine typography plus lifelike skin, fabric and glassFrom 6 credits per image
- Qwen Image 3.0 APIReadable signs and headlines rendered into the imageFrom 5 credits per image
- Qwen Image 2 APISimple prompt-to-image and one-photo editsFrom 6 credits per image
- Qwen Image 2512 LoRA APIQwen Image 2512 renders and edits with your own LoRAsFrom 5 credits per image
- Qwen Image Edit 2509 LoRA APIMulti-photo Qwen edits that load your own LoRAsFrom 5 credits per image
- Qwen Image 1.0 LoRA APIOriginal Qwen-Image with clean lettering and your own LoRAsFrom 5 credits per image


