black-forest-labs/flux-1-schnell-lora/text-to-imageFrom 1 credit per image· Create Image

FLUX.1 Schnell LoRA runs FLUX.1 [schnell], Black Forest Labs' 12-billion-parameter FLUX model distilled to work in a handful of steps, with up to three of your own LoRA files per request. FLUX.1 [dev] LoRAs load on it and showed through at scale 1 in our tests.

Call it with the model name black-forest-labs/flux-1-schnell-lora/text-to-image on POST /jobs/createTask, from 1 credit per image ($0.01). New accounts get 30 free credits to try it in the Playground first.

  • Create Image
  • Edit Image
  • Up to 1.5K
  • 9 aspect ratios
  • Loads your own LoRA

Introduction

FLUX.1 Schnell LoRA Text to image draws one image from a written prompt on FLUX.1 [schnell], Black Forest Labs' 12-billion-parameter model distilled to work in a handful of sampling steps, with up to three of your own LoRA files loaded. Its weights are Apache-2.0. FLUX.1 [dev] LoRAs load on it, and in our tests style LoRAs showed through at scale 1.

Choose a mode by starting material

What you haveMode
a written descriptionFLUX.1 Schnell LoRA Text to image
a picture to restyle or inpaintFLUX.1 Schnell LoRA Image editing

Key features

Three at once

Up to three LoRAs per request, each with a scale from 0 to 4. In our test a request with three stacked at 0.8, 0.6 and 0.3 ran normally.

Nine shapes

Nine aspect ratios of about one megapixel, from 21:9 (1536 x 640) to 9:21. Every one came back at exactly the requested size in our tests.

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, composition and lighting. If a LoRA has a trigger word, put it first.
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
Standard0.9$0.009

Each task is rounded up to whole credits, so one run at the lowest tier costs 1 credit per image ($0.01).

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

Use cases

Testing LoRAs before a bigger run

Try a FLUX LoRA, its trigger and its scale here, then move the settings that work to a slower base.

Prompt guide & pro tips

No guidance or step controls

The model is distilled to run without them, so this endpoint has neither. Steer it with the prompt, the LoRA and its scale.

Write sentences

Describe subject, clothing, place, light and lens. Hard, named light ("a single hard top light", "chalk dust in the beam") renders well.

Start LoRAs at 1

Style LoRAs showed through at scale 1 here. Compare with scale 0 on the same seed; if the two images match, the file did not apply.

Watch for signatures

Try another seed if one appears.

API quick start

Call the FLUX.1 Schnell 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 black-forest-labs/flux-1-schnell-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": "black-forest-labs/flux-1-schnell-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "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.

FLUX.1 Schnell LoRA API questions

How much does the FLUX.1 Schnell LoRA API cost?

FLUX.1 Schnell LoRA starts at 1 credit ($0.01) 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 FLUX.1 Schnell LoRA in the API?

Put black-forest-labs/flux-1-schnell-lora/text-to-image for Create Image; black-forest-labs/flux-1-schnell-lora/edit for Edit Image in the model field of POST /jobs/createTask.

How does the mask work?

On image editing, send a black-and-white image the size of the source as the mask. White areas are redrawn from your prompt, black areas are kept. Follow the object's outline; a hard rectangle across hair left a seam in our test.

What are the limits of the FLUX.1 Schnell LoRA API?

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 FLUX.1 Schnell LoRA without writing code?

Yes. The Playground runs FLUX.1 Schnell LoRA on your PopNow credits, needs no API key, and shows the matching code for every run.

All FLUX models

FLUX.1 Dev LoRA gives the full-quality Dev model for the same LoRAs.

More about FLUX.1 Schnell LoRA