Flux-2-Max (generates images)

Official Documentation: https://api.bfl.ml/scalar#tag/models/POST/v1/flux-2-max
Please refer to the official documentation; all parameters are consistent with the official documentation.

We have added the sync parameter to support synchronous return of results for easier debugging. When set to true, the result will be returned synchronously.

Explanation of Some Parameters

Parameter Name	Parameter Explanation
safety_tolerance	The tolerance level for content review of input and output. A higher level means looser review restrictions.
webhook_url	The URL to receive Webhook notifications for asynchronously obtaining generation results.
webhook_secret	An optional secret key for Webhook signature verification to enhance request security.
steps	The number of iteration steps for image generation. More steps result in richer image details but slower generation speed.
prompt_upsampling	Whether to perform upsampling optimization on the prompt to improve prompt understanding accuracy.
guidance	Guidance strength, which controls the degree of alignment between the generated result and the prompt. A higher value means higher alignment but lower creativity.
interval	The interval for outputting intermediate results during generation, used to check the generation progress.

Functional Features

📝 Text-driven generation: Generate high-quality images based on prompts, suitable for various creative scenarios such as artistic creation, product design, and scene rendering.

🖼️ Multi-image assisted creation: Supports up to 8 input images for assisted generation, enabling advanced effects like image fusion, style transfer, and content expansion.

⚙️ Highly customizable configuration: Allows customization of image height, output format, and flexible control of content review strictness through the safety tolerance parameter.

📊 Asynchronous task management: Returns task results asynchronously, including key information such as task ID and polling address, facilitating task tracking.

Steps for Using the Asynchronous Interface:

Use the generation interface (/flux/v1/flux-2-max), fill in the corresponding parameters, and obtain the task ID.

Use the query interface (/flux/v1/get_result) and fill in the task ID to obtain the result.

FLUX 2 MAX Billing Rules

Base Rates

Billing Item	Rate
Input (Reference Images)	0.03PTC / Megapixel (MP)
Output Images	0.07PTC for the first megapixel, 0.03PTC for each subsequent megapixel

Megapixel (MP) Calculation Rules

1 Megapixel (MP) = 1,048,576 pixels (i.e., 1024×1024);

Image megapixel calculation method: (Width × Height) ÷ 1,048,576;

The megapixel count of each image is individually rounded up to the nearest whole number.

Common Resolution Conversion Examples

Resolution	Actual Calculated MP	Billed Rounded MP
512×512	0.26	1
1280×720 (720p)	0.92	1
1024×1024	1	1
1920×1080 (1080p)	2.07	3

Reference Image Processing Rules

Single reference image: Original resolution is retained (up to 4 MP); if exceeding 4 MP, it is automatically downsampled to 4 MP;

Multiple reference images: If a single reference image's original resolution exceeds 1 MP, it is automatically downsampled to 1 MP;

Regardless of the actual resolution, each reference image is billed at a minimum of 1 MP;

Maximum resolution limit for output images: 4 MP.

Billing Examples

Text-to-Image (1024×1024)
Output 1 MP → Cost = 0.07PTC

Text-to-Image (1920×1080)
Output 3 MP → Cost = 0.07PTC + (2 × 0.03PTC) = 0.13PTC

Image-to-Image (1 reference image of 1920×1080 + 1024×1024 output)
Input 3 MP + Output 1 MP → Cost = (3 × 0.03PTC) + 0.07PTC = 0.16PTC

Image-to-Image (3 reference images + 1024×1024 output)
Input 3 MP (3×1 MP) + Output 1 MP → Cost = (3 × 0.03PTC) + 0.07PTC = 0.16PTC

Request

Header Params

Body Params application/json

Examples

Text-to-imageImage editing

{
  "prompt": "ein fantastisches bild",
  "width": 1024,
  "height": 768,
  "steps": 40,
  "prompt_upsampling": false,
  "seed": 42,
  "guidance": 2.5,
  "safety_tolerance": 2,
  "interval": 2,
  "output_format": "jpeg",
  "sync": false

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

{ "id": "5015d102-09e0-44e9-8ede-ab8c74b16ed6", "polling_url": "https://api.us3.bfl.ai/v1/get_result?id=5015d102-09e0-44e9-8ede-ab8c74b16ed6", "cost": 6.0, "input_mp": 0.0, "output_mp": 0.75 }

Explanation of Some Parameters#

Functional Features#

FLUX 2 MAX Billing Rules#