scrollport
Back to Media creation

FLUX.2 Flash Edit

Black Forest Labs

Edit one or more images from a text instruction with configurable output size and format.

Capability
Image editing
Current price
$0.0070/megapixel
Availability
Ready to run
Last accepted verification

What this API does

Apply a targeted edit with FLUX 2 Flash while preserving the source composition. fal bills each resized input megapixel and each generated output megapixel; all outputs are persisted as private PNG artifacts.

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

Public input and output shape

Input

enable_prompt_expansionboolean · optional

Value supplied for enable prompt expansion.

guidance_scalenumber · optional

Value supplied for guidance scale.

minimum: 0 · maximum: 20

image_sizestring · optional

Value supplied for image size.

image_urlsarray · required

Value supplied for image urls.

minItems: 1 · maxItems: 4

num_imagesinteger · optional

Value supplied for num images.

minimum: 1 · maximum: 4

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-flash-edit",
  "input": {
    "prompt": "change the plain studio background to deep cobalt blue while preserving the burger",
    "image_size": "square_hd",
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_outputs/flux-2-flash-edit-input.png"
    ],
    "num_images": 1
  }
}

Output

{
  "note": "images returned as artifacts",
  "images": [
    {
      "width": 1024,
      "height": 1024,
      "content_type": "image/png"
    }
  ]
}
Teaching errors and limitations
  • invalid_input: image_urls must contain one to four public image URLsexample: {"prompt":"change the bottle cap to deep cobalt blue while preserving the product photograph","image_urls":["https://storage.googleapis.com/falserverless/example_outputs/flux-2-flash-edit-input.png"],"image_size":"square_hd","num_images":1}
Updated
18 August 2026

Use FLUX.2 Flash Edit with Scrollport

Use 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.