models/Black Forest Labs/FLUX.2 [Pro] Preview

Black Forest Labs

FLUX.2 [Pro] Preview

image

FLUX.2 [pro] Preview is Black Forest Labs' recommended default for production image generation and editing — tracks the latest [pro] weights with strong multi-reference support.

MODALITIES

image

PER IMAGE

$0.0000

USAGE

676.9M

0% market share

RELEASED

2026-05-27

FLUX.2 [Pro] Preview (black-forest-labs/flux-2-pro-preview) is a image model from Black Forest Labs, released 2026-05-27. Pricing via AIgateway: $0.0000 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="black-forest-labs/flux-2-pro-preview". Best for: Marketing assets, Product mockups, Concept art.

model · black-forest-labs/flux-2-pro-previewfamily · FLUX

Use this model

model: black-forest-labs/flux-2-pro-preview

curl https://api.aigateway.sh/v1/images/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"black-forest-labs/flux-2-pro-preview","prompt":"a serene cyberpunk city at dusk"}'

curl https://api.aigateway.sh/v1/images/generations \ -H "Authorization: Bearer $AIGATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"black-forest-labs/flux-2-pro-preview","prompt":"a cyberpunk cat"}'

Capabilities

Strengths

Text-to-image generation
Creative control

Use cases

Marketing assetsProduct mockupsConcept art

Adoption

676.9M tokens

53.4K requests · 0% of tracked market volume

See the full leaderboard →

Aggregate usage across the open model ecosystem (as of 2026-05-22).

Pricing

Per image$0.0000

You pay pass-through · 5% applied at credit top-up, not per-call.

Try in playground →Compare API reference See usage ranking →

Collections

More image models →More from Black Forest Labs →Frontier models →Free-tier models →

API schema

Call FLUX.2 [Pro] Preview from any OpenAI SDK

POST https://api.aigateway.sh/v1/images/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json

{
  "model": "black-forest-labs/flux-2-pro-preview",
  "prompt": "A cyberpunk cat at sunset, cinematic lighting",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"   // or "b64_json"
}

Response

json

{
  "created": 1776947082,
  "data": [
    { "url": "https://media.aigateway.sh/img/abc123.png" }
    // or { "b64_json": "iVBORw0KGgoAAAANSUhEU..." }
  ]
}

Quickstart

from openai import OpenAI
client = OpenAI(base_url="https://api.aigateway.sh/v1", api_key="sk-aig-...")

r = client.images.generate(
    model="black-forest-labs/flux-2-pro-preview",
    prompt="a cyberpunk cat at sunset",
    size="1024x1024",
)
print(r.data[0].url)

Errors

401authentication_errorInvalid or missing API key

402insufficient_creditsWallet empty (PAYG only)

404not_foundUnknown model or endpoint

429rate_limit_errorOver per-minute limit — see Retry-After header

500server_errorUpstream provider failed (retryable)

503service_unavailableUpstream saturated (retryable)

Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is FLUX.2 [Pro] Preview?

FLUX.2 [pro] Preview is Black Forest Labs' recommended default for production image generation and editing — tracks the latest [pro] weights with strong multi-reference support. It is a image model from Black Forest Labs, accessible via AIgateway's OpenAI-compatible API at slug black-forest-labs/flux-2-pro-preview.

How much does FLUX.2 [Pro] Preview cost via AIgateway?

$0.0000 per image. Pass-through plus a 5% platform fee applied at top-up.

How do I call FLUX.2 [Pro] Preview from my code?

Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "black-forest-labs/flux-2-pro-preview". The request and response shapes match OpenAI exactly.

Does FLUX.2 [Pro] Preview support streaming, tool calling, vision, and JSON mode?

Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.

What are the best use cases for FLUX.2 [Pro] Preview?

Marketing assets, Product mockups, Concept art. Key strengths: Text-to-image generation; Creative control.

Can I bring my own Black Forest Labs API key (BYOK)?

Yes. Attach a Black Forest Labs key in your AIgateway dashboard and this model flips to pass-through — you pay Black Forest Labs directly and AIgateway waives the 5% platform fee on those calls.