FLUX.2 Pro API: settings, cost and integration

Read in Russian

Published: Oct 24, 2026, 3:47 AM UTC · Updated: Oct 24, 2026, 3:47 AM UTC

Exact ID: FLUX.2-pro. Check access for your key using GET /v1/models; a published model does not guarantee access for every account.

Prices and billing units

API429 catalog generated Oct 24, 2026, 5:33 AM UTC. The table shows direct request components; other general catalog metrics are not added here. Display prices are rounded to six decimal places; calculations use exact catalog rates. The calculator below follows the direct Images request contract. Sources checked: Oct 24, 2026.

BFL: $0.03 for the first output MP and $0.015 for each additional MP, without references. One MP equals 1,048,576 pixels. References follow separate native rules and are not estimated as an API429 price. Pricing sources are listed below. Batch, cache and special modes are kept separate from the base comparison.

Image generation budget

Specifications and compatibility boundaries

• BFL describes FLUX.2 [pro]: native generation and editing, up to eight API references and output up to 4MP. The public API429 catalog does not establish equal limits.
• Native fixed flux-2-pro and changing flux-2-pro-preview differ. The API429 ID FLUX.2-pro does not establish a binding to fixed weights.
• For generation without references, 1/2/4 billed MP are published. At BFL, one MP equals 1,048,576 pixels, rounded upward. API429 reference pricing is not confirmed.

Specification: Black Forest Labs, checked Oct 24, 2026. These are not verified effective API429 limits. Check native manufacturer parameters and capabilities separately for the client method.

Published capabilities for this exact ID: image_editing image_generation . A missing field is not evidence of a prohibition, but it does not establish compatibility.

Public model observations

There are no fresh observations with confirmed traffic for this model. This does not mean zero latency or prove an absence of errors.

Source: public 24-hour statistics. The mean is neither a median nor a response time guarantee; it is not a quality assessment of the image.

First request: curl, Python, JavaScript

Set API429_API_KEY on the server and check the exact ID using GET https://gateway.api429.com/v1/models using the same Bearer key. Generation incurs a charge; there are no automatic retries. An uncertain timeout does not prove there was no charge.

The examples request one result and b64_json. curl saves JSON to image-response.json; Python and JavaScript decode the file after checking MIME by signature. When choosing url, first distinguish a hosted URL from a data URI. Check warnings, partial results, api429.outputs and api429.parameter_mismatches, if present.

curl

curl --fail-with-body https://gateway.api429.com/v1/images/generations \
  -H "Authorization: Bearer $API429_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"FLUX.2-pro","prompt":"A ceramic cup on a wooden table in soft morning light, no lettering.","n":1,"size":"1024x1024","response_format":"b64_json"}' \
  --output image-response.json

Python 3

import base64
import json
import os
import urllib.request
from pathlib import Path

key = os.environ["API429_API_KEY"]
base = "https://gateway.api429.com/v1"
headers = {"Authorization": "Bearer " + key, "Content-Type": "application/json"}
model = "FLUX.2-pro"
with urllib.request.urlopen(urllib.request.Request(base + "/models", headers=headers), timeout=30) as response:
    available = {item["id"] for item in json.load(response)["data"]}
if model not in available:
    raise ValueError("Model unavailable to this key")
payload = json.loads("{\"model\":\"FLUX.2-pro\",\"prompt\":\"A ceramic cup on a wooden table in soft morning light, no lettering.\",\"n\":1,\"size\":\"1024x1024\",\"response_format\":\"b64_json\"}")
request = urllib.request.Request(base + "/images/generations",
    data=json.dumps(payload).encode("utf-8"), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
    result = json.load(response)
if result.get("warnings") or result.get("api429", {}).get("parameter_mismatches"):
    print("Inspect output warnings:", result.get("warnings"), result.get("api429"))
items = result.get("data", [])
if len(items) != 1 or not items[0].get("b64_json"):
    raise ValueError("Missing image or partial result; inspect before retrying")
raw = base64.b64decode(items[0]["b64_json"], validate=True)
if raw.startswith(b"\x89PNG\r\n\x1a\n"):
    extension = "png"
elif raw.startswith(b"\xff\xd8\xff"):
    extension = "jpg"
elif raw.startswith(b"RIFF") and raw[8:12] == b"WEBP":
    extension = "webp"
else:
    raise ValueError("Unknown image MIME; inspect before saving")
Path("image." + extension).write_bytes(raw)
print(result.get("api429", {}).get("outputs"))

JavaScript: Node.js 18+

import { writeFile } from "node:fs/promises";
const key = process.env.API429_API_KEY;
if (!key) throw new Error("Set API429_API_KEY");
const base = "https://gateway.api429.com/v1";
const headers = { Authorization: "Bearer " + key, "Content-Type": "application/json" };
const model = "FLUX.2-pro";
const available = await fetch(base + "/models", { headers, signal: AbortSignal.timeout(30000) });
if (!available.ok) throw new Error("Models HTTP " + available.status);
if (!(await available.json()).data.some(item => item.id === model)) throw new Error("Model unavailable to this key");
const payload = {"model":"FLUX.2-pro","prompt":"A ceramic cup on a wooden table in soft morning light, no lettering.","n":1,"size":"1024x1024","response_format":"b64_json"};
const response = await fetch(base + "/images/generations", {
 method: "POST", headers, body: JSON.stringify(payload), signal: AbortSignal.timeout(180000)
});
if (!response.ok) throw new Error("Generation HTTP " + response.status);
const result = await response.json();
if (result.warnings || result.api429?.parameter_mismatches) console.warn("Inspect warnings", result.warnings, result.api429);
if (result.data?.length !== 1 || !result.data[0].b64_json) throw new Error("Missing image or partial result; inspect before retrying");
const bytes = Buffer.from(result.data[0].b64_json, "base64");
const hex = bytes.subarray(0, 8).toString("hex");
const extension = hex === "89504e470d0a1a0a" ? "png" : hex.startsWith("ffd8ff") ? "jpg" : bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP" ? "webp" : undefined;
if (!extension) throw new Error("Unknown image MIME; inspect before saving");
await writeFile("image." + extension, bytes);
console.log(result.api429?.outputs);

The examples are checked offline against the client contract and public schema. No paid execution or result quality is claimed. A verified complete image jobs contract is not available here: asynchronous fields and polling are omitted.

n8n: HTTP Request and saving the result

1. Check access to the exact ID using GET /v1/models.
2. Create an HTTP Request with POST to https://gateway.api429.com/v1/images/generations; store the Bearer key in credentials.
3. Send the JSON from curl with one result. Do not include the key in a workflow export.
4. Parse JSON, check the data count and warnings; decode b64_json and check MIME before saving.

HTTP Request documentation. Compatibility with specialized AI nodes and native SDKs needs separate verification.

Three options for your own comparison

Compare identical tasks and acceptance criteria. These are image models, not a quality ranking; conditional rows apply to their own configurations and do not form an equivalent benchmark.

Version and release date

Manufacturer release date, Black Forest Labs: Nov 25, 2025. The exact predecessor has not been established in the reviewed sources. This does not automatically replace the ID. The model’s addition date in API429 is unknown.

Frequently asked questions

Sources and review

• docs.bfl.ai/flux_2/flux2_overview
• bfl.ai/blog/flux-2
• bfl.ai/pricing
• docs.bfl.ai/flux_2/flux2_image_editing
• gateway.api429.com/api/public/catalog
• gateway.api429.com/api/public/openapi.json
• client.api429.com/documentation

Editorial review: Oct 24, 2026. Pricing · Getting started · Compare the family: FLUX