FLUX.1 Dev LoRA Edit Image API: Load Your Own LoRAs

Name: FLUX.1 Dev LoRA API
SKU: black-forest-labs/flux-1-dev-lora/edit
Price: 0.03 USD
Availability: InStock

Introduction

FLUX.1 Dev LoRA Image editing changes one source image on Black Forest Labs' FLUX.1 [dev], guided by your prompt and up to three of your own LoRA files. Without a mask it restyles the whole frame, and a strength value from 0 to 1 decides how far it moves from the source. With a black-and-white mask it redraws only the white area and keeps the rest.

Choose a mode by starting material

What you have	Mode
a picture to change, whole or in part	FLUX.1 Dev LoRA Image editing
a written description only	FLUX.1 Dev LoRA Text to image

Key features

Masked inpainting

Paint the area to change white and everything else black. In our tests a torso mask on a studio portrait replaced the top while the face, the hair and the trousers stayed as they were.

Strength you can reason about

The default 0.8 keeps pose and layout; 0.95 lets the model redraw nearly everything, the face included. With a mask, 0.9 to 1 makes sure the white area really changes.

Request parameters

Parameter	Required	Description
`guidance_scale`	No	How strictly the model follows the prompt. ≥ 0 · ≤ 20 · Default: 3.5
`image_url`	Yes	The picture to start from.
`loras`	No	Load your own LoRA files to lock in a style or character. Default: []
`mask_url`	No	Paint over the area that should change.
`output_format`	No	File type of the result. jpeg · png · webp · Default: jpeg
`prompt`	Yes	Describe the whole image you want back; with a mask, describe what belongs in the white area.
`seed`	No	Reuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647
`steps`	No	More steps add detail but take longer. ≥ 1 · ≤ 50 · Default: 28
`strength`	No	How far the result may move away from your input. ≥ 0 · ≤ 1 · Default: 0.8

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
Standard	2.7	$0.027

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

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

Prompt guide & pro tips

Describe the result, not the instruction

Write what the final image should contain.

Feather hard mask edges

A hard rectangle leaves a visible seam where it meets the kept pixels. Soften the edge of the mask or follow the outline of the object you want to replace.

Start at 0.8, then move in steps of 0.05

If the source bleeds through, raise strength; if the face drifts, lower it. Keep the seed fixed while you compare so that strength is the only thing changing.

API quick start

Call the FLUX.1 Dev 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 black-forest-labs/flux-1-dev-lora/edit 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": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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 Dev LoRA API questions

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

FLUX.1 Dev LoRA starts at 3 credits ($0.03) per image with Edit 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 Dev LoRA in the API?

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

Which LoRAs work here?

LoRAs trained for FLUX.1 [dev], which is the largest group of community image LoRAs. Pass a direct download link to the .safetensors file. SDXL, Z-Image or Qwen-Image LoRAs will not transfer.

Can I use the images commercially?

Black Forest Labs' FLUX.1 [dev] license lets you use generated images for personal, scientific and commercial purposes. The license of each LoRA you load is set by its author, so check its model card.

What does guidance do?

It sets how strictly the image follows the prompt. The default 3.5 suits most LoRAs; realism LoRAs often look more natural a little lower, around 2 to 3.