FLUX.1 Dev ControlNet LoRA API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du FLUX.1 Dev ControlNet LoRA aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: Black Forest Labs
Ergebnis: Bild
Ab: 5.4 Credits pro Bild ($0.054)
Modell-IDs: black-forest-labs/flux-1-dev-controlnet-lora/text-to-image

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Bild erstellen

black-forest-labs/flux-1-dev-controlnet-lora/text-to-image

Preis

Option	Credits (pro Bild)	US-Dollar
`Standard`	5.4	$0.054

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`prompt`Pflicht	`string`	—	bis zu 5.000 Zeichen	Describe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
`control_image_url`Pflicht	`string (uri)`	—	—	Control image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio.
`control_strength`Optional	`number`	`0.7`	0 bis 1	How strongly the result follows the control image, from 0 to 1.
`control_guidance_start`Optional	`number`	`0`	0 bis 1	Fraction of the denoising steps at which the control image starts to apply, from 0 to 1.
`control_guidance_end`Optional	`number`	`0.8`	0 bis 1	Fraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start.
`resolution`Optional	`string`	`1k`	1k, 1.5k	Length of the output's long side: 1k is 1024 pixels, 1.5k is 1536. The control image's aspect ratio is kept.
`num_outputs`Optional	`integer`	`1`	1 bis 4	How many images to generate in one run, from 1 to 4.
`loras`Optional	`array<object>`	`[]`	bis zu 3 Einträge	Up to three LoRA weight files trained for FLUX.1 dev, each with its own strength.
`guidance_scale`Optional	`number`	`3.5`	0 bis 20	How closely the image follows the prompt, from 0 to 20.
`steps`Optional	`integer`	`28`	1 bis 50	Denoising steps, from 1 to 50. Fewer steps return faster and a little softer.
`output_format`Optional	`string`	`jpeg`	jpeg, png, webp	Container of the returned image.
`seed`Optional	`integer`	—	0 bis 2147483647	Random seed for controlled comparisons.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in control_image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "num_outputs": 1
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"