Flux 2 Max Edit

Flux 2 Max Edit

Playground

Try it on WaveSpeedAI!

FLUX 2 Max Edit delivers production-grade image-to-image editing from Black Forest Labs—apply natural-language instructions and exact hex color control for consistent, studio-quality results. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

FLUX.2 [max] Edit is the top-tier image editing engine of the FLUX family, built for production teams who need reliable, high-fidelity edits from natural language instructions. It can take one or several reference images plus a prompt and turn them into clean, on-brand transformations suitable for final delivery—not just drafts.


Suitable for

  • Campaign key visuals and hero images
  • Brand-accurate product and packaging refreshes
  • E-commerce and marketing asset pipelines
  • Automated, high-value editing jobs where failure is expensive

Production-focused editing model

Rather than exposing a long list of inference knobs, FLUX.2 [pro] Edit is tuned to behave the same way every time: you pass in image(s) and a prompt, it returns a polished edit. Internal settings are fixed for production use, so non-experts and API-driven workflows both get stable behaviour without babysitting parameters.


Practical advantages

Multi-reference aware edits

Use several input images in the same request when you need to match outfits, backgrounds, or stylistic cues—pro understands how they relate and applies changes accordingly.

Plain-language control

Describe edits in normal English (“make the background a clean studio grey and match the logo colour to our brand red”) instead of painting masks, cutting layers, or writing complex configs. Hex colours for brand palettes are supported when you need exact matches.

Structure-preserving transformations

Refines lighting, texture, and local detail while keeping composition, perspective, and identity intact, so the result looks like a carefully shot original rather than an obviously patched image.

Minimal setup, maximum throughput

No guidance scales, schedulers, or step counts to tune—just prompt-to-edit. That makes it easy to plug into batch jobs, web backends, or no-code tools without a separate “parameter tuning” phase.

Consistent behaviour at scale

A fixed optimisation profile plus seed control mean that large edit batches behave predictably, which is crucial for A/B testing, QA, and evergreen production flows.

Outputs that drop into your pipeline

Exports standard PNG or JPEG so edited assets can go straight into design tools, websites, print workflows, or further post-maxduction with no extra conversion steps.


Parameters

  • Size: The size of generated media in pixels(width*Height).

Pricing

  • $0.07 per edited image

FLUX.2 family on WaveSpeedAI

Use FLUX.2 [pro] Edit alongside the rest of the FLUX.2 lineup for a complete generate-and-edit stack:


More Image Tools on WaveSpeedAI

  • Nano Banana Pro – Google’s Gemini-based text-to-image model for sharp, coherent, prompt-faithful visuals that work great for ads, keyframes, and product shots.
  • Seedream V4 – ’s style-consistent, multi-image generator ideal for posters, campaigns, and large batches of on-brand illustrations.
  • Qwen Edit Plus – an enhanced Qwen-based image editor for precise inpainting, cleanup, and local style changes while preserving overall composition.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "images": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
  ],
  "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/flux-2-max/edit" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagesarray<string>Yes-1 ~ 3 itemsList of URLs of input images for editing. The maximum number of images is 3.
seedintegerNo-1-The random seed to use for the generation. -1 means a random seed will be used.
enable_sync_modebooleanNofalse-If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models.
enable_base64_outputbooleanNofalse-If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayOutput values, usually URL strings; some models return text strings or structured result objects (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction
data.modelstringModel ID used for the prediction
data.outputsarray<string | object>Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to poll for the prediction result
data.statusstringStatus: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2026 WaveSpeedAI. All rights reserved.