Start building

Flux 2 Dev Edit

bfl/flux-2/dev/edit

Flux 2 Dev Edit is BFL's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Use in agentGet API key
Base price
$0.0012USD / run
Execution
async
Model type
image
Input fields
7

Try the model

Playground

Open playground
Input
The prompt to edit the image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URLs of the images for editing. A maximum of 4 images are allowed, if more are provided, only the first 4 will be used.
020
Guidance Scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Range: 0 to 20.
450
The number of inference steps to perform. Range: 4 to 50.
The format of the generated image. Allowed values: jpeg, png.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
The seed to use for the generation. If not provided, a random seed will be used.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price
$0.0012 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
BFL
Model ID
bfl/flux-2/dev/edit
Execution
async
API
Unified Run API
Endpoint
/v1/run

API README

Flux 2 Dev Edit

Flux 2 Dev Edit is the editable FLUX.2 Dev workflow for source-led visual transformation and experimentation. It combines FLUX.2’s contextual image understanding with an adaptable development-oriented model, enabling changes to objects, backgrounds, styles, text, and scene structure while the reference image remains the basis for identity and composition.

Use this route for prototyping custom editing pipelines, research, and controlled creative revision where the Dev model’s flexibility is valuable. Name the source elements that must remain recognizable, describe the exact semantic or appearance change, and specify how new content should match existing perspective, lighting, texture, typography, and visual hierarchy.

Highlights

  • Context-aware source editing. Understands the reference scene before applying the requested semantic or appearance change.
  • Multi-element reconstruction. Revises objects, setting, style, text, and composition while maintaining scene coherence.
  • Preservation-aware generation. Keeps unrequested identity, structure, and visual details connected to the source.
  • Development-oriented adaptability. Supports experimentation and customized workflows around FLUX.2’s editable model behavior.

Pricing

ConfigurationBilling unitPrice
Base generationPer request$0.0012

When to Use

✅ Good fit❌ Consider alternatives
The project needs this exact generation or editing routeThe intended task belongs to video, audio, or 3D media
Available references match every required local fieldRequired source assets or rights are unavailable
The brief can specify composition, color, and finishOutput must be deterministic at pixel level
Supported dimensions and formats fit final placementDelivery requires unsupported canvas specifications
An asynchronous generated image fits productionA live frame-synchronous response is mandatory

Prompt Guide

Write a complete visual brief: identify the subject and references, define composition and viewpoint, describe lighting, palette, materials, typography, and finish, then list exact preservation constraints. FLUX.2 Klein does not rely on prompt upsampling, so use clear descriptive sentences rather than sparse keywords.

{
  "prompt": "A photorealistic editorial composition with precise subject placement, controlled lighting, exact colors, and clean typography",
  "seed": 1,
  "images": [
    "https://example.com/reference.jpg"
  ],
  "aspect_ratio": "21:9"
}

Technical Specs

SpecValue
Model IDbfl/flux-2/dev/edit
Input fieldsseed (integer)<br>images (array)<br>prompt (string)<br>aspect_ratio (string; 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16)<br>output_format (string; jpeg, png)<br>guidance_scale (number; 0–20)<br>num_inference_steps (integer; 4–50)
Required inputprompt
Output fieldsurl, content_type
ExecutionAsynchronous job

Related Models

  • bfl/flux-2-lora-gallery/apartment-staging
  • bfl/flux-2-lora-gallery/face-to-full-portrait
  • bfl/flux-2-lora-gallery/multiple-angles

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
bfl/flux-2/dev/edit
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "bfl/flux-2/dev/edit",
  "images": [
    "https://static.sandbase.ai/examples/bfl/flux-2/dev/edit/input_images_0.png"
  ],
  "prompt": "Change his clothes to casual suit and tie",
  "output_format": "png",
  "guidance_scale": 2.5,
  "num_inference_steps": 28
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All language models
ModelContextInput / 1MOutput / 1MReleased
Flux 2 Dev EditThis model
BFL		———Nov 23, 2025
FLUX Virtual Try-On
BFL		———May 28, 2026
Flux Pro Erase
BFL		———May 21, 2026
Flux 2 Pro
BFL		———May 14, 2026
FLUX.2 [klein] 9B LoRA
BFL		———Mar 17, 2026
FLUX.2 [klein] 9B LoRA
BFL		———Mar 17, 2026