FLUX.1 Dev ControlNet LoRA API

About FLUX.1 Dev ControlNet LoRA

FLUX.1 Dev ControlNet LoRA generates images with Black Forest Labs' FLUX.1 [dev] guided by Shakker Labs' ControlNet Union Pro 2.0, with up to three LoRA files trained for FLUX.1 dev. One control image (a pose skeleton, a depth map, canny or soft-edge lines, or a grayscale photo) fixes the layout; the prompt decides the rest, and nothing is filtered.

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

Introduction

FLUX.1 Dev ControlNet LoRA Text to image generates images with FLUX.1 [dev], the 12-billion-parameter model from Black Forest Labs, guided by ControlNet Union Pro 2.0 from Shakker Labs, with up to three of your own LoRA files loaded. One control image fixes the pose, depth or outlines; the prompt decides who and what is in the picture.

Key features

One network, five kinds of map

Canny lines, soft edges, depth, pose skeletons and grayscale photos all work through the same endpoint. There is no mode switch: the model reads the map you send.

Strength and timing controls

Control strength (0 to 1) sets how firmly the map is followed, and the start and end of the control window set when it applies during denoising.

Your own LoRAs

Up to three FLUX.1 dev LoRAs load per request.

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 6 credits per image ($0.06).

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

Use cases

Matching a pose

Extract or draw a skeleton once and render the same pose with any person and outfit.

Restaging a photograph

Keep a photo's composition through its canny, soft-edge or grayscale map and change the cast, wardrobe and light.

Series with one layout

Reuse a control map so every image in a set shares the same framing.

Prompt guide & pro tips

Choose the map by what should change

A pose skeleton leaves clothing and bodies to the prompt.

Start from the suggested settings

Shakker Labs suggests strength 0.7 with the window ending at 0.8 for canny and soft edge, 0.8 for depth, and about 0.9 with the window ending at 0.65 for pose maps.

Match the aspect ratio

The output takes the shape of the control image. Crop the map to the frame you want before you send it.

Check the LoRA base model

Only FLUX.1 dev LoRAs work. A LoRA for another model family fails the request rather than being ignored.

API quick start

Call the FLUX.1 Dev ControlNet 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-dev-controlnet-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-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "num_outputs": 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 Dev ControlNet LoRA API questions

All FLUX models

FLUX.1 Dev LoRA has no control image and suits free composition.

• FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image
• FLUX 3 APIVideo with synced sound and a quick draft tierFrom 45 credits for a 5-second clip
• FLUX.2 Klein 9B LoRA APIFast FLUX.2 Klein 9B that loads up to three of your LoRAsFrom 3 credits per image
• FLUX.2 Klein Base 9B LoRA APIUndistilled Klein 9B for varied looks with your LoRAsFrom 4 credits per image
• FLUX.2 Klein 4B LoRA APISmall, quick FLUX.2 Klein 4B with your own LoRAsFrom 3 credits per image
• FLUX.2 Klein Base 4B LoRA APIUndistilled Klein 4B that loads your own LoRAsFrom 3 credits per image
• FLUX.2 Klein 9B APIFast FLUX edits that keep faces and poses intactFrom 2 credits per image
• FLUX.2 Klein 4B APIThe smallest, quickest FLUX for rapid draftsFrom 2 credits per image
• FLUX.2 Dev LoRA APIFLUX.2 Dev images and edits with your own LoRAsFrom 4 credits per image
• FLUX.2 Pro APIPhotoreal images with readable text and hex color controlFrom 5 credits per image
• FLUX.2 Flex APISpells headlines and labels exactly as writtenFrom 9 credits per image
• FLUX.2 Dev APIOpen-weights FLUX that can merge people into one sceneFrom 2 credits per image
• FLUX.1 Krea Dev LoRA APIPhotographic FLUX.1 Krea with your own LoRAsFrom 4 credits per image
• FLUX.1 Dev ControlNet LoRA APIPose, depth or edge control on FLUX.1 with your LoRAsFrom 6 credits per image
• FLUX.1 Fill Dev LoRA APIMasked inpainting on FLUX.1 Fill with your own LoRAsFrom 7 credits per image
• FLUX.1 Dev LoRA APIClassic FLUX.1 Dev with up to three of your LoRAsFrom 3 credits per image
• FLUX.1 Schnell LoRA APIFast FLUX.1 Schnell that loads your own LoRAsFrom 1 credit 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
• Anima Turbo LoRA APIAnime art with your own style or character LoRAsFrom 3 credits per image
• Krea 2 Turbo LoRA APIKrea 2 Turbo images and restyles with your own LoRAsFrom 4 credits per image
• P-Image LoRA APIFast P-Image renders and edits with one LoRA of your ownFrom 1 credit per image
• Z-Image Base LoRA APIZ-Image Base with up to three of your own LoRAsFrom 3 credits per image

More about FLUX.1 Dev ControlNet LoRA

Try it

FLUX.1 Dev ControlNet LoRA AI Image Generator onlineCreate images with FLUX.1 Dev ControlNet LoRA in PopNow

Docs

FLUX.1 Dev ControlNet 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 FLUX.1 Dev ControlNet LoRA results without polling