FLUX.2 Pro

Black Forest Labs

Generate images from text prompts with configurable aspect ratio, resolution and output format.

Current price
$0.0420/megapixel
Availability
Ready to run
Last accepted verification

What this API does

Create one studio-grade image with FLUX 2 Pro. Scrollport pins safety checks and output format, persists the generated JPEG privately, and prices the first output megapixel separately from additional megapixels.

Agents select this operation with tool ID blackforestlabs.flux-2-pro, then inspect its current executable contract before a run.

Public input and output shape

Input

image_sizestring · optional

Value supplied for image size.

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 5000

seedinteger · optional

Value supplied for seed.

Output

imagesarray

Returned images value.

notestring

Returned note value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "blackforestlabs.flux-2-pro",
  "input": {
    "prompt": "a premium reusable water bottle on a stone plinth, soft editorial studio light",
    "image_size": "landscape_4_3"
  }
}

Output

{
  "note": "images returned as artifacts",
  "images": [
    {
      "width": 1024,
      "height": 768,
      "content_type": "image/jpeg"
    }
  ]
}
Teaching errors and limitations
  • invalid_input: prompt is required and custom image dimensions must stay inside the published boundsexample: {"prompt":"a premium reusable water bottle on a stone plinth, soft editorial studio light","image_size":"landscape_4_3"}
Updated
18 August 2026

Use FLUX.2 Pro with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.