# Black Forest Labs

## Docs

- [Credits & Billing](https://docs.bfl.ml/account_management/credits_billing.md): Add credits, track usage, and handle billing for your organization
- [Organizations & Projects](https://docs.bfl.ml/account_management/organizations_projects.md): Organize your teams, manage API keys, and control access with Organizations and Projects.
- [Team Management](https://docs.bfl.ml/account_management/team_management.md): Invite team members, assign roles, and manage access to your organizations and projects.
- [Get the user's credits](https://docs.bfl.ml/api-reference/get-the-users-credits.md): Get the user's credits
- [Create an image with FLUX.1 Kontext [max] (legacy, use FLUX.2 [PRO] for editing)](https://docs.bfl.ml/api-reference/models/create-an-image-with-flux1-kontext-[max]-legacy-use-flux2-[pro]-for-editing.md): Submits an image creation task with FLUX.1 Kontext [max]. For image editing, prefer FLUX.2 [PRO] (/flux-2-pro) or FLUX.2 [FLEX] (/flux-2-flex) which are the recommended default models for editing workflows.
- [Create an image with FLUX.1 Kontext [pro] (legacy, use FLUX.2 [PRO] for editing)](https://docs.bfl.ml/api-reference/models/create-an-image-with-flux1-kontext-[pro]-legacy-use-flux2-[pro]-for-editing.md): Submits an image creation task with FLUX.1 Kontext [pro]. For image editing, prefer FLUX.2 [PRO] (/flux-2-pro) or FLUX.2 [FLEX] (/flux-2-flex) which are the recommended default models for editing workflows.
- [Expand an image by adding pixels on any side.](https://docs.bfl.ml/api-reference/models/expand-an-image-by-adding-pixels-on-any-side.md): Submits an image expansion task that adds the specified number of pixels to any combination of sides (top, bottom, left, right) while maintaining context.
- [Generate an image with FLUX 1.1 [pro].](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux-11-[pro].md): Submits an image generation task with FLUX 1.1 [pro].
- [Generate an image with FLUX 1.1 [pro] finetune with ultra mode.](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux-11-[pro]-finetune-with-ultra-mode.md): Submits an image generation task with FLUX 1.1 [pro] finetune with ultra mode.
- [Generate an image with FLUX 1.1 [pro] with ultra mode and optional raw mode.](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux-11-[pro]-with-ultra-mode-and-optional-raw-mode.md): Submits an image generation task with FLUX 1.1 [pro] with ultra mode and optional raw mode.
- [Generate an image with FLUX.1 [dev].](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux1-[dev].md): Submits an image generation task with FLUX.1 [dev].
- [Generate an image with FLUX.1 Fill [pro] finetune using an input image and mask.](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux1-fill-[pro]-finetune-using-an-input-image-and-mask.md): Submits an image generation task with the FLUX.1 Fill [pro] finetune model using an input image and mask. Mask can be applied to alpha channel or submitted as a separate image.
- [Generate an image with FLUX.1 Fill [pro] using an input image and mask.](https://docs.bfl.ml/api-reference/models/generate-an-image-with-flux1-fill-[pro]-using-an-input-image-and-mask.md): Submits an image generation task with the FLUX.1 Fill [pro] model using an input image and mask. Mask can be applied to alpha channel or submitted as a separate image.
- [Generate or edit an image with FLUX.2 [FLEX] (recommended for editing)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[flex]-recommended-for-editing.md): Submits an image generation or editing task with FLUX.2 [FLEX]. This is a recommended model for image editing and generation. Supports flexible text-to-image and image-to-image editing workflows.
- [Generate or edit an image with FLUX.2 [Klein 4B] (fastest editing)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[klein-4b]-fastest-editing.md): Submits an image generation or editing task with FLUX.2 [Klein 4B]. Fastest, most lightweight model for image generation and editing.
- [Generate or edit an image with FLUX.2 [Klein 9B KV] (fast editing with caching)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[klein-9b-kv]-fast-editing-with-caching.md): Submits an image generation or editing task with FLUX.2 [Klein 9B] with KV caching for improved performance.
- [Generate or edit an image with FLUX.2 [Klein 9B] (fast editing)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[klein-9b]-fast-editing.md): Submits an image generation or editing task with FLUX.2 [Klein 9B]. Fast, lightweight model for image generation and editing.
- [Generate or edit an image with FLUX.2 [MAX] (highest quality)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[max]-highest-quality.md): Submits an image generation or editing task with FLUX.2 [MAX]. Highest quality FLUX.2 model for image generation and editing.
- [Generate or edit an image with FLUX.2 [PRO] Preview (recommended for editing)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[pro]-preview-recommended-for-editing.md): Submits an image generation or editing task with FLUX.2 [PRO] Preview. This is a recommended model for image editing and generation.
- [Generate or edit an image with FLUX.2 [PRO] (recommended for editing)](https://docs.bfl.ml/api-reference/models/generate-or-edit-an-image-with-flux2-[pro]-recommended-for-editing.md): Submits an image generation or editing task with FLUX.2 [PRO]. This is the recommended default model for image editing and generation. Supports text-to-image and image-to-image editing workflows.
- [Report Model Usage](https://docs.bfl.ml/api-reference/models/report-model-usage.md)
- [Delete Finetune](https://docs.bfl.ml/api-reference/utility/delete-finetune.md): Delete a finetune_id that was created by the user
- [Finetune Details](https://docs.bfl.ml/api-reference/utility/finetune-details.md): Get details about the training parameters and other metadata connected to a specific finetune_id that was created by the user.
- [Get Result](https://docs.bfl.ml/api-reference/utility/get-result.md): An endpoint for getting generation task result.
- [My Finetunes](https://docs.bfl.ml/api-reference/utility/my-finetunes.md): List all finetune_ids created by the user
- [Errors](https://docs.bfl.ml/api_integration/errors.md): Reference for HTTP status codes and response types returned by the FLUX API, including error handling guidance.
- [FLUX API Integration Guide](https://docs.bfl.ml/api_integration/integration_guidelines.md): Essential guide for integrating with FLUX API endpoints, including endpoint selection, polling, and content handling.
- [FLUX MCP server](https://docs.bfl.ml/api_integration/mcp_integration.md): Generate, edit, vary, browse, and reuse FLUX.2 images from any MCP-compatible client. OAuth sign-in, all FLUX.2 models, no API keys to manage.
- [FLUX.2 Image Editing](https://docs.bfl.ml/flux_2/flux2_image_editing.md): Edit images with FLUX.2 using text prompts and multi-reference support for up to 10 images, with advanced controls and up to 4MP output.
- [FLUX.2 [klein] Training](https://docs.bfl.ml/flux_2/flux2_klein_training.md): Fine-tune FLUX.2 [klein] models with custom datasets using LoRA training for specialized image generation.
- [FLUX.2 [klein] Style Training](https://docs.bfl.ml/flux_2/flux2_klein_training_example.md): Technical guide for training style LoRAs on FLUX.2 [klein] models with a Graphic Impressions style example
- [Overview](https://docs.bfl.ml/flux_2/flux2_overview.md): FLUX.2 model family overview — from sub-second generation to highest quality, with multi-reference editing, color control, and up to 4MP output.
- [FLUX.2 Text to Image](https://docs.bfl.ml/flux_2/flux2_text_to_image.md): FLUX.2 is the recommended model for text-to-image generation. Generate high-fidelity images with advanced control, exact colors, and flexible aspect ratios.
- [FLUX1.1 [pro] Image Generation](https://docs.bfl.ml/flux_models/flux_1_1_pro.md): Generate images with FLUX1.1 [pro], a fast and reliable text-to-image model with strong prompt adherence and competitive pricing.
- [FLUX1.1 [pro] Ultra Mode](https://docs.bfl.ml/flux_models/flux_1_1_pro_ultra_raw.md): Generate up to 4MP resolution images with FLUX1.1 [pro] Ultra, featuring Raw mode for candid photography and image-to-image support.
- [FLUX Outpainting](https://docs.bfl.ml/flux_outpainting.md): Expand any image beyond its borders in a single call.
- [FLUX.1 Fill [pro]](https://docs.bfl.ml/flux_tools/flux_1_fill.md): Use FLUX.1 Fill for text-driven inpainting and outpainting to edit image regions or extend borders.
- [Multi-Reference Editing](https://docs.bfl.ml/guides/prompting_editing_multi_reference.md): Combine multiple input images for style transfer, composites, and editorial scenes
- [Image Editing](https://docs.bfl.ml/guides/prompting_editing_overview.md): Overview of image editing with FLUX.2 — swap backgrounds, replace objects, transfer styles, and combine multi-reference images in natural language.
- [Single-Reference Editing](https://docs.bfl.ml/guides/prompting_editing_single_reference.md): How to edit images using a single reference with FLUX.2
- [FLUX Prompting Guide](https://docs.bfl.ml/guides/prompting_summary.md): Learn how to prompt FLUX — from the basics to advanced techniques.
- [Prompting Basics](https://docs.bfl.ml/guides/prompting_unified_basics.md): Core concepts and foundational knowledge for prompting FLUX models
- [Building a Good Prompt](https://docs.bfl.ml/guides/prompting_unified_building.md): How FLUX reads prompts and how to structure them into clear, controllable image instructions
- [Prompt Reference](https://docs.bfl.ml/guides/prompting_unified_reference.md): Cheat sheet with camera terms, lighting and style keywords, and ready-to-use example prompts
- [Style, Aesthetics & Text](https://docs.bfl.ml/guides/prompting_unified_style.md): Style keywords, photorealistic looks, illustration styles, and how to get readable text in images
- [Technical Parameters](https://docs.bfl.ml/guides/prompting_unified_technical.md): Aspect ratios and working without negative prompts
- [Use Cases](https://docs.bfl.ml/guides/prompting_unified_usecases.md): Real-world applications from marketing and design to e-commerce and image editing
- [Character & Style Consistency](https://docs.bfl.ml/guides/usecases_editing_character_consistency.md): Maintaining consistent characters and styles across image edits with FLUX
- [Fashion](https://docs.bfl.ml/guides/usecases_editing_clothing_tryon.md): Change outfits, add accessories, and recolor garments on existing photos with FLUX.2, using hex color codes for precise control.
- [Pose & Layout Guidance](https://docs.bfl.ml/guides/usecases_editing_controlnets.md): Use reference images to control pose, composition, and spatial layout in FLUX
- [Drawing to Image (Rendering)](https://docs.bfl.ml/guides/usecases_editing_drawing_rendering.md): Rendering drawings into images with FLUX editing
- [Interior Design](https://docs.bfl.ml/guides/usecases_editing_interior_design.md): Use FLUX.2 to repaint walls, swap flooring, restyle rooms, and adjust lighting in existing interior photos for instant design visualization.
- [Lighting and Weather Transformation](https://docs.bfl.ml/guides/usecases_editing_lighting_weather.md): Transforming lighting and weather in images with FLUX editing
- [Multi-Image Referencing and Compositing](https://docs.bfl.ml/guides/usecases_editing_multi_image_compositing.md): Multi-image referencing and compositing with FLUX editing
- [Object Removal](https://docs.bfl.ml/guides/usecases_editing_object_removal.md): Cleanly remove objects, watermarks, and blemishes from images with FLUX.2 image editing while seamlessly filling the surrounding background.
- [Insert the Person Into a Scene](https://docs.bfl.ml/guides/usecases_editing_person_in_scene.md): Inserting a person into a scene with FLUX editing
- [Product Consistency](https://docs.bfl.ml/guides/usecases_editing_product_consistency.md): Maintaining product consistency across image edits with FLUX
- [Style Transfer](https://docs.bfl.ml/guides/usecases_editing_style_transfer.md): Re-render images in different artistic mediums with FLUX.2 image editing while preserving original composition, subject, and key details.
- [HEX Color Code Prompting](https://docs.bfl.ml/guides/usecases_t2i_hex_color_prompting.md): Use hex color codes in FLUX.2 prompts for precise color matching — ideal for brand consistency, design work, and exact color control.
- [Infographics](https://docs.bfl.ml/guides/usecases_t2i_infographics.md): Generate clean, structured infographics with FLUX by specifying layout, content hierarchy, icons, and color palette in your prompts.
- [JSON Structured Prompting](https://docs.bfl.ml/guides/usecases_t2i_json_prompting.md): Use structured JSON prompts for precise control over complex scenes
- [Multi-Language Prompting](https://docs.bfl.ml/guides/usecases_t2i_multi_language.md): Prompt FLUX.2 in native languages for culturally authentic results
- [Photorealistic Images](https://docs.bfl.ml/guides/usecases_t2i_photorealistic.md): Generate photorealistic images with FLUX.2 across macro photography, cinematic landscapes, and documentary scenes using lens and lighting prompts.
- [Product Mockups](https://docs.bfl.ml/guides/usecases_t2i_product_mockups.md): Creating product mockups with transparent backgrounds and label integrity using FLUX
- [Typography & Design](https://docs.bfl.ml/guides/usecases_t2i_typography_design.md): Generate clean typography, product ads, magazine covers, and posters with FLUX.2
- [UI Mockups](https://docs.bfl.ml/guides/usecases_t2i_ui_mockups.md): Generate website layouts, app interfaces, and game UI mockups with FLUX from descriptive prompts about structure and visual style.
- [World Knowledge](https://docs.bfl.ml/guides/usecases_t2i_world_knowledge.md): Leveraging FLUX's world knowledge in image generation
- [Image Editing](https://docs.bfl.ml/kontext/kontext_image_editing.md): FLUX.1 Kontext image editing model. For new projects, we recommend FLUX.2 with multi-reference support and up to 4MP output.
- [Introduction](https://docs.bfl.ml/kontext/kontext_overview.md): Overview of FLUX.1 Kontext, a model that combines text-to-image generation with context-aware image editing. For new projects, we recommend FLUX.2.
- [Image Generation](https://docs.bfl.ml/kontext/kontext_text_to_image.md): Generate images from text prompts using FLUX.1 Kontext. For new projects, we recommend FLUX.2 for text-to-image generation.
- [Image Generation with Text Prompts](https://docs.bfl.ml/quick_start/generating_images.md): Complete guide to FLUX API endpoints for AI image generation. Learn text-to-image creation, API polling, regional endpoints, and code examples.
- [Quick Start](https://docs.bfl.ml/quick_start/get_started.md): Get started with the FLUX API in minutes. Create your account, add credits, set up your API key, and generate your first image.
- [Welcome to BFL Documentation!](https://docs.bfl.ml/quick_start/introduction.md): Explore FLUX models for text-to-image generation and image editing. Find quick start guides, API references, and prompting tips.
- [Overview](https://docs.bfl.ml/quick_start/pricing.md): Credit-based pricing for all FLUX models including FLUX.2, FLUX.1, and batch requests. 1 credit equals $0.01 USD.
- [Release Notes](https://docs.bfl.ml/release-notes.md): Latest FLUX model releases, API changes, performance upgrades, and feature announcements from Black Forest Labs.

## OpenAPI Specs

- [openapi](https://api.bfl.ai/openapi.json)

## Optional

- [BFL Homepage](https://bfl.ai)
- [Help Center](https://help.bfl.ai)