Black Forest LabsFastUltra

FLUX 2 Max

The highest fidelity image model from Black Forest Labs. Best-in-class prompt following and the most consistent editing in the FLUX.2 lineup — preserves colors, lighting, faces, text, and objects across edits with up to 8 reference images.

160 credits

per image at 1 MP — varies by resolution (0.5MP 130, 2MP 230, 4MP/match_input 370, custom 390)

Highest editing consistency in the FLUX.2 lineup — preserves identity, colors, lighting, and text

Best-in-class prompt following for both short and long prompts

Multi-reference editing with up to 8 input images

Systematic product color variations controlled by hex codes in the prompt

New 3D views of a scene from a single image or small reference set

Nearly as fast as FLUX.2 [pro] — up to 3x faster than competing models of similar quality

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "black-forest-labs/flux-2-max",
  "input": {
    "prompt": "A photorealistic wide shot of a minimalist digital billboard in a forest of purple and lavender-hued trees. Centered text reads \"FLUX.2 [max]\" in a modern sans-serif font. Soft daylight with a purple color cast, cinematic composition",
    "resolution": "1 MP",
    "aspect_ratio": "1:1"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt for image generation
`input_images`	array	No	[]	Up to 8 reference images (jpeg, png, gif, or webp) for image-to-image generation
`aspect_ratio`	string	No	1:1	Aspect ratio. 'match_input_image' follows the first input image; 'custom' uses width/height match_input_imagecustom1:116:93:22:34:55:49:163:44:3
`resolution`	string	No	1 MP	Output resolution in megapixels. 2 MP or below recommended; max image size is 2048x2048. Billing scales with resolution match_input_image0.5 MP1 MP2 MP4 MP
`width`	integer	No	-	Width (256-2048, multiple of 16). Only used when aspect_ratio=custom
`height`	integer	No	-	Height (256-2048, multiple of 16). Only used when aspect_ratio=custom
`safety_tolerance`	integer	No	2	Safety tolerance: 1 is most strict, 5 is most permissive
`seed`	integer	No	-	Random seed for reproducible generation
`output_format`	string	No	webp	Output image format webpjpgpng
`output_quality`	integer	No	80	Save quality 0-100 (not relevant for png)

How to Provide File Input

There are 3 ways to provide files for the input_images parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=black-forest-labs/flux-2-max" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:input_images=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "black-forest-labs/flux-2-max",
  "input": {
    "prompt": "your prompt here",
    "input_images": ["https://example.com/image.jpg"]
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Photorealistic Scene with Text

Complex scene with accurate in-image text rendering

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "black-forest-labs/flux-2-max",
  "input": {
    "prompt": "A photorealistic wide shot of a minimalist digital billboard in a forest of purple and lavender-hued trees. Centered text reads \"FLUX.2 [max]\" in a modern sans-serif font. Soft daylight with a purple color cast, cinematic composition",
    "resolution": "1 MP",
    "aspect_ratio": "1:1"
  }
}'

Multi-Reference Product Edit

Consistent product mockup across a new environment

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "black-forest-labs/flux-2-max",
  "input": {
    "prompt": "Place the product from the reference image on a marble kitchen counter with soft morning light, keeping the label text and colors exactly as shown",
    "input_images": [
      "https://example.com/product.jpg"
    ],
    "resolution": "2 MP",
    "aspect_ratio": "4:5"
  }
}'