PopNowAPI Docs
Main content

FLUX 3 Klein API reference

Fast FLUX 3 Klein images and multi-reference edits at 1K or 2K

Call FLUX 3 Klein from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.

At a glance

Made by
Black Forest Labs
Output
Image
From
$0.012 USD per image
Typical time
about 21 s

Prices are in USD, charged to your PopNow balance. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.

Create Image

black-forest-labs/flux-3-klein/text-to-image

Price

OptionUSD
1k$0.012 per image
2k$0.048 per image

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersDescribe the subject, setting, light and style in plain sentences.
aspect_ratioOptionalstring1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, 3:1, … (+2)Output aspect ratio; custom lets you set width and height.
resolutionOptionalstring1k1k, 2kOutput size tier: 1k is about one megapixel, 2k about four.
widthOptionalinteger—256 to 1024Output width in pixels when aspect_ratio is custom, 256 to 1024 (1024 if left out); height works the same way. The price still follows resolution.
heightOptionalinteger—256 to 1024Output height in pixels when aspect_ratio is custom, 256 to 1024 (1024 if left out); width works the same way. The price still follows resolution.
enable_prompt_expansionOptionalbooleanfalse—Rewrite the prompt into a fuller description before generating. Off by default, so the prompt is followed word for word.
output_formatOptionalstringjpegjpeg, png, webpFile format of the returned image.
seedOptionalinteger—0 to 2147483647Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3-klein/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",
    "resolution": "1k"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

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"

Edit Image

black-forest-labs/flux-3-klein/edit

Price

OptionUSD
1k$0.0192 per image
2k$0.0768 per image

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersSay what to change and what must stay the same; name each source as <ref_image_1>, <ref_image_2>.
image_urlsRequiredarray<string (uri)>—up to 10 itemsOne to ten source images, in the order your prompt refers to them. The second and third each raise the price a little; more do not.
aspect_ratioOptionalstringautoauto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2, … (+3)Output aspect ratio; auto keeps the shape of the first source image, custom lets you set width and height.
resolutionOptionalstring1k1k, 2kOutput size tier: 1k is about one megapixel, 2k about four.
widthOptionalinteger—256 to 1024Output width in pixels when aspect_ratio is custom, 256 to 1024 (1024 if left out); height works the same way. The price still follows resolution.
heightOptionalinteger—256 to 1024Output height in pixels when aspect_ratio is custom, 256 to 1024 (1024 if left out); width works the same way. The price still follows resolution.
enable_prompt_expansionOptionalbooleanfalse—Rewrite the prompt into a fuller description before generating. Off by default, so the prompt is followed word for word.
output_formatOptionalstringjpegjpeg, png, webpFile format of the returned image.
seedOptionalinteger—0 to 2147483647Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_urls. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3-klein/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "1k"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

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"

Next steps

On this page