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
| Option | USD |
|---|---|
1k | $0.012 per image |
2k | $0.048 per image |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | Describe the subject, setting, light and style in plain sentences. |
aspect_ratioOptional | string | 1:1 | 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:1, … (+2) | Output aspect ratio; custom lets you set width and height. |
resolutionOptional | string | 1k | 1k, 2k | Output size tier: 1k is about one megapixel, 2k about four. |
widthOptional | integer | — | 256 to 1024 | Output 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. |
heightOptional | integer | — | 256 to 1024 | Output 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_expansionOptional | boolean | false | — | Rewrite the prompt into a fuller description before generating. Off by default, so the prompt is followed word for word. |
output_formatOptional | string | jpeg | jpeg, png, webp | File format of the returned image. |
seedOptional | integer | — | 0 to 2147483647 | Random 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.
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.
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
| Option | USD |
|---|---|
1k | $0.0192 per image |
2k | $0.0768 per image |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | Say what to change and what must stay the same; name each source as <ref_image_1>, <ref_image_2>. |
image_urlsRequired | array<string (uri)> | — | up to 10 items | One 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_ratioOptional | string | auto | auto, 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. |
resolutionOptional | string | 1k | 1k, 2k | Output size tier: 1k is about one megapixel, 2k about four. |
widthOptional | integer | — | 256 to 1024 | Output 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. |
heightOptional | integer | — | 256 to 1024 | Output 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_expansionOptional | boolean | false | — | Rewrite the prompt into a fuller description before generating. Off by default, so the prompt is followed word for word. |
output_formatOptional | string | jpeg | jpeg, png, webp | File format of the returned image. |
seedOptional | integer | — | 0 to 2147483647 | Random 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.
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.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"
