> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bfl.ml/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Notes

> Latest FLUX model releases, API changes, performance upgrades, and feature announcements from Black Forest Labs.

<Update label="June 9, 2026">
  ## FLUX Outpainting — New Fast Mode

  FLUX Outpainting now supports a `mode` parameter that trades quality for speed.

  ### Key Features

  * **`mode: "fast"`** — Significantly faster extension, well-suited for landscapes, backgrounds, textures, and products. Typically lower cost.
  * **`mode: "high"` (default)** — Unchanged highest-fidelity path; recommended when fine detail, prompt adherence, or consistency with complex source content matters.
  * **Same contract** — Both modes share the same request fields and response format; omit `mode` to keep the existing `high` behavior.

  ### Endpoint

  `POST /v1/flux-tools/outpainting-v1`

  See [Choosing a mode](/flux_tools/flux_outpainting#choosing-a-mode) in the FLUX Outpainting documentation.
</Update>

<Update label="May 28, 2026">
  ## FLUX Virtual Try-On — See Any Garment On Any Person

  A new FLUX Tools endpoint that applies clothing to a person image while preserving their face and pose — built for interactive, low-latency applications.

  ### Key Features

  * **Flexible references** — Single garments, multi-garment outfits, and model-to-model references
  * **Packshot or on-model** — Accepts both flat-lay garment images and on-model imagery
  * **Low latency** — Optimized for fitting rooms, social filters, and interactive experiences
  * **Up to 2MP input** — Larger inputs auto-downscale to \~1MP

  ### Endpoint

  `POST /v1/flux-tools/vto-v1`

  Get started in the [FLUX Virtual Try-On documentation](/flux_tools/flux_vto), or try the [public demo](https://flux-tools.bfl.ai/virtual-try-on).
</Update>

<Update label="May 21, 2026">
  ## FLUX Erase — Remove Anything, Leave No Trace

  A new FLUX Tools endpoint for clean, prompt-free object removal. Provide an image and a binary mask; the model removes the masked content and reconstructs the scene coherently.

  ### Key Features

  * **Broad removal scope** — Objects, people, text, watermarks, and complex compositions
  * **Coherent reconstruction** — Automatically matches lighting, texture, and background
  * **Optional edge expansion** — Cleaner results on soft-edged subjects
  * **No prompt required** — Just an image and a binary mask

  On a held-out benchmark of 198 object-removal images, FLUX Erase matches or outperforms frontier alternatives at substantially lower cost.

  ### Endpoint

  `POST /v1/flux-tools/erase-v1`

  Get started in the [FLUX Erase documentation](https://docs.bfl.ai/flux_tools/flux_erase), try the [public demo](https://flux-tools.bfl.ai/erase), or read the [announcement](https://bfl.ai/blog/flux-erase-remove-anything-leave-no-trace).
</Update>

<Update label="May 14, 2026">
  ## FLUX Outpainting — Extend Any Image in Any Direction

  A new FLUX Tools endpoint that extends an image beyond its borders in a single call — no prompt required.

  ### Key Features

  * **Natural scene extension** — Carries lighting, texture, depth, and composition past the original frame
  * **Flexible canvas control** — Direct width / height and reference placement via `reference_offset_x` / `reference_offset_y`
  * **Up to 4MP output** — Production-ready resolutions for banners, social formats, and aspect-ratio changes
  * **No prompt needed** — The model continues the existing scene on its own

  ### Endpoint

  `POST /v1/flux-tools/outpainting-v1`

  Get started in the [FLUX Outpainting documentation](/flux_tools/flux_outpainting), try the [public demo](https://flux-tools.bfl.ai/outpainting), or read the [announcement](https://bfl.ai/blog/outpainting-extend-any-image-in-any-direction).
</Update>

<Update label="March 3, 2026">
  ## FLUX.2 \[pro] Speed Upgrade & Preview Endpoint

  FLUX.2 \[pro] is now approximately **2x faster** across both text-to-image and image editing — with no quality loss and no price change.

  * **\~2x faster generation** — Across text-to-image and image editing workloads
  * **No quality loss** — On par with the original across all benchmarks
  * **No price change** — Faster generation at the same price
  * **Same API contract** — Drop-in upgrade, no code changes required

  ### New: `flux-2-pro-preview` Endpoint

  We're introducing `flux-2-pro-preview`, where our latest FLUX.2 \[pro] improvements land first. This speed upgrade is available now on `flux-2-pro-preview`, and the endpoint will continue to be updated as we ship new capabilities.

  The existing `flux-2-pro` endpoint remains **unchanged** as a fixed snapshot for workflows that require reproducibility.

  Learn more in the [Preview Endpoint documentation](/flux_2/flux2_overview#preview-endpoints).
</Update>

<Update label="February 17, 2026">
  ## Webhook Payloads Now Match Polling Responses

  Webhook payloads are now consistent with polling responses.

  ### What Changed

  * Status field now returns `Ready` instead of `SUCCESS`

  ### Action Required

  If your webhook handler checks for `SUCCESS` status, update it to check for `Ready` instead.
</Update>

<Update label="January 29, 2026">
  ## FLUX.2 \[flex] Performance Update

  FLUX.2 \[flex] is now up to **3x faster** while maintaining the same quality. Typography rendering, prompt adherence, and fine-grained control remain unchanged.
</Update>

<Update label="January 15, 2026">
  ## FLUX.2 \[klein] Launch

  We're excited to announce **FLUX.2 \[klein]** — our fastest model family with **sub-second inference**.

  ### Key Features

  * **Sub-second generation** — Real-time image generation for interactive applications
  * **Two variants** — 4B from (\$0.014 / image) and 9B from (\$0.015 / image) models
  * **Runs on consumer hardware** — As little as 13GB VRAM required
  * **Open weights available** — 4B under Apache 2.0, 9B under FLUX Non-Commercial License

  ### API Endpoints

  * `flux-2-klein-4b` — Fastest, ideal for high-volume and local deployment
  * `flux-2-klein-9b` — Balanced quality and speed with 8B Qwen3 text embedder

  Download open weights from [Hugging Face](https://huggingface.co/black-forest-labs) or get started with the [API documentation](/flux_2/flux2_text_to_image).
</Update>

<Update label="January 8, 2026">
  ## Credit Transfer

  You can now **transfer credits between organizations** directly from the dashboard.

  * Navigate to your organization's Credits page
  * Click "Transfer Credits" to move credits to another organization you own
  * Credits transfer instantly with full audit logging
</Update>

<Update label="December 16, 2025">
  ## FLUX.2 \[max] Launch

  Introducing **FLUX.2 \[max]** — our highest quality model with groundbreaking capabilities.

  ### Key Features

  * **Maximum quality** — Highest editing consistency, strongest prompt following, and faithful style representation
  * **Grounding search** — Generate images grounded in real-time information from the web
  * **Multi-reference editing** — Combine up to 10 input images while maintaining identity
  * **Vast world knowledge** — Create visuals of current events, real-time weather, or historical moments

  ### Grounding Search Examples

  FLUX.2 \[max] can search the web to visualize:

  * Yesterday's football scores
  * Real-time weather in any city
  * Recent news events
  * Historical moments from specific dates and locations

  Try it in the [playground](https://playground.bfl.ai) or via the [API](/flux_2/flux2_text_to_image).
</Update>

<Update label="December 15, 2025">
  ## Organizations & Projects

  We've introduced a new way to organize your teams and work with **Organizations** and **Projects**.

  ### What's New

  * **Organizations** - Create organizations to group your projects and team members. Each organization has its own billing, credits, and member management.
  * **Projects** - Organize your work into projects with dedicated API keys, usage tracking, and spending limits.
  * **Role-Based Access Control** - Invite team members with granular permissions: Administrator, Developer, Billing Manager, or Viewer.
  * **Project-Scoped API Keys** - API keys are now tied to specific projects for better security and tracking.
  * **Spending Limits** - Set daily, weekly, and monthly credit limits per project.
  * **Activity Logging** - Full audit trail of all organizational activity.

  ### For Existing Users

  Your account has been automatically migrated:

  * A "Default" organization was created with your existing credits
  * A "Default" project contains your existing API keys
  * **Your API keys continue to work** - no changes required

  Learn more in our [Organizations & Projects documentation](/account_management/organizations_projects).
</Update>

<Update label="November 25, 2025">
  ## FLUX.2 \[pro] and \[flex] Launch

  Introducing the next generation of FLUX models — **FLUX.2 \[pro]** and **FLUX.2 \[flex]**.

  ### FLUX.2 \[pro]

  Production-grade image generation at scale.

  * **Top performance at affordable price** — High quality generation from \$0.03/MP
  * **Fast turnaround** — Optimized for high-volume applications
  * **Multi-reference editing** — Combine up to 8 input images (10 in playground)
  * **Photorealistic output** — Closes the gap between generated and real imagery

  ### FLUX.2 \[flex]

  Fine-grained control for precise results.

  * **Specialized for typography** — Best-in-class text rendering
  * **Adjustable parameters** — Control inference steps (up to 50) and guidance scale (1.5–10)
  * **Detail preservation** — Maintains small details in complex scenes
  * **Production workflows** — Ideal for designs requiring exact specifications

  ### Key Capabilities

  Both models support:

  * **Exact color control** — Specify brand colors via hex codes with precision matching
  * **Structured prompting** — JSON-style prompts for automated workflows
  * **Multi-reference editing** — Character consistency, style transfer, and pose guidance
  * **Up to 4MP output** — High-resolution generation at any aspect ratio

  Get started with the [API documentation](/flux_2/flux2_text_to_image) or try them in the [playground](https://playground.bfl.ai).
</Update>

<Update label="October 31, 2025">
  ## API Deprecations - Now In Effect

  As of today, the Flux Pro 1.0 endpoints (`flux-pro-1.0`, `flux-pro-1.0-depth`, `flux-pro-1.0-canny`) and the Finetuning API are officially deprecated. See details in the October 3 announcement below.
</Update>

<Update label="October 3, 2025">
  ## API Deprecations

  ### October 31, 2025 - Flux Pro 1.0 Endpoints

  The following endpoints will be deprecated. Migrate to [flux-pro-1.1](https://docs.bfl.ai/flux_models/flux_1_1_pro#using-flux1-1-%5Bpro%5D-api-for-text-to-image-generation) or [flux-kontext-pro](https://docs.bfl.ai/kontext/kontext_text_to_image#using-flux-1-kontext-api-for-text-to-image-generation).

  **Deprecated endpoints:**

  * `flux-pro-1.0`
  * `flux-pro-1.0-depth`
  * `flux-pro-1.0-canny`

  **Migration targets:**

  * [FLUX1.1 \[pro\] documentation](https://docs.bfl.ai/flux_models/flux_1_1_pro)
  * [FLUX.1 Kontext \[pro\] documentation](https://docs.bfl.ai/kontext/kontext_text_to_image)

  ### October 31, 2025 - Finetuning API

  The finetuning API will be deprecated, including all finetuning-related endpoints.

  **Deprecated endpoints:**

  * `/v1/finetune`
  * `flux-pro-finetuned`
  * `flux-pro-1.1-ultra-finetuned`
  * `flux-pro-1.0-depth-finetuned`
  * `flux-pro-1.0-canny-finetuned`
  * `flux-pro-1.0-fill-finetuned`

  No migration path available. Finetuning functionality will be discontinued.
</Update>
