flux-3-image

Name: flux-3-image API
Brand: Black Forest Labs

AliasFlux 3 Image

by Black Forest LabsImage

Flux 3 Image API by Black Forest Labs on TTAPI supports text-to-image, reference editing, multi-image composition, prompt bounding boxes, and optional web grounding up to 4K.

ReferencesUp to 10images per request

Resolution4Khighest output tier

FlowAsyncjobId → image

Billing40% offofficial pricing

Forest streetwear — official Black Forest Labs flux-3-image showcase

Forest streetwearExample 01

Mohair profileExample 02

Rain-track racers — official Black Forest Labs flux-3-image showcase

Rain-track racersExample 03

Chair construction diagram — official Black Forest Labs flux-3-image showcase

Chair construction diagramExample 04

Examples

Flux 3 official image examples

Adapted visual description; original generation prompt not published. Studio portrait with red lettering on a cream uniform and a vivid blue backdrop.

Adapted visual description; original generation prompt not published. A textured botanical poster with playful walking seedlings and decorative headline typography.

Adapted visual description; original generation prompt not published. A streetwear figure with an oversized hood and pink trousers on a woodland path.

Adapted visual description; original generation prompt not published. Fashion portrait combining reflective blue fibers, pastel checks, and dark studio lighting.

Adapted visual description; original generation prompt not published. Aerial landscape photography of a waterfall surrounded by dense vegetation and a winding trail.

Adapted visual description; original generation prompt not published. Overhead fashion photography with sculptural red fabric and tropical greenery.

Adapted visual description; original generation prompt not published. A collectible stamp featuring runners, textured paper, and a deep green presentation.

Adapted visual description; original generation prompt not published. An overhead editorial portrait with headphones, braided hair, and saturated orange lighting.

Adapted visual description; original generation prompt not published. A playful minimalist character constructed from a hat, eyes, and small legs.

Capabilities

What you can build with flux-3-image

Text to image

Describe a scene and choose an explicit aspect ratio and resolution tier.

Reference editing

Pass images to edit details, restyle a scene, or combine up to 10 references.

Prompt layout boxes

Use a normalized 0–1000 coordinate grid inside the prompt to describe placement or edit regions.

Model-specific controls

Standard Image exposes grounding; Klein instead adds paired width and height, seed, jpeg/png output, and 1–16 steps.

Pricing

Per-action, in quota

Usage is metered in quota by model, action, and output settings.

Flux 3 Image generation and editingOfficial pricing

ModelTTAPI billingUnit

flux-3-image40% off official/ image

API request

Headers and submit parameters

Use the endpoint below with your TTAPI key and the request fields shown.

GeneratePOST

/bfl/v1/flux-3-image

Create, edit, or combine images in an asynchronous Flux 3 task.

Official reference

FetchGET

/flux/fetch

Read task status and retrieve the generated image using jobId.

Official reference

POSThttps://api.ttapi.io/bfl/v1/flux-3-image

Headers

TT-API-KEYstringrequired

Your TTAPI API key.

Content-Typestringrequired

Use application/json.

Body

promptstringrequired

Describe a new image or an edit. Refer to inputs in order as image 1, image 2, and so on. Optional layout boxes use a 0–1000 [top, left, bottom, right] grid in the prompt.

imagesstring | string[]optional

Omit for text-to-image; supply 1–10 HTTP(S) URLs or base64 images for editing or composition. Each input must be at least 256 × 256 pixels.

aspect_ratioenumoptional

Defaults to auto. Supports 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, and 9:21. Auto follows the prompt or first reference; text-only fallback is 1:1.

resolutionenumoptional

768sq, 1k, 1.5k, 2k, or 4k. Defaults to 1k; final dimensions depend on the aspect ratio.

safety_toleranceintegeroptional

0–7, default 2; lower values are stricter. The approved maximum depends on the route and organization.

groundingbooleanoptional

Defaults to true and permits web and image search grounding. Set false to disable both searches and use the prompt only.

webhook_urlstringoptional

Callback URL for the asynchronous task. The submission returns jobId; use the callback or Flux Fetch to get the image.

Open the official TTAPI documentation

Integrate

From key to first result

Copy the resolved endpoint, authentication headers, and request body for this model.

curl --request POST \
  --url https://api.ttapi.io/bfl/v1/flux-3-image \
  --header 'TT-API-KEY: $TTAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"prompt":"Editorial photograph of a ceramic tea set on a linen table, soft daylight and realistic textures.","aspect_ratio":"3:4","resolution":"1k","grounding":false}'