Black Forest Labs Editing API
Image editing tools (fill, expand, erase).
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/black-forest-labs:black-forest-labs-editing-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Black Forest Labs FLUX Editing API
description: 'Asynchronous image generation API from Black Forest Labs. Submit a
generation request to a model-specific endpoint and poll
`/v1/get_result` (or use the optional webhook callback) for the
finished image. Includes the FLUX, FLUX.1, and FLUX.2 model families,
Fill/Expand image editing tools, credit lookup, and fine-tune
management.'
version: '1.0'
contact:
name: Black Forest Labs
url: https://docs.bfl.ai
servers:
- url: https://api.bfl.ai
description: Global
- url: https://api.us.bfl.ai
description: United States region
- url: https://api.eu.bfl.ai
description: European region (GDPR)
security:
- apiKey: []
tags:
- name: Editing
description: Image editing tools (fill, expand, erase).
paths:
/v1/flux-pro-1.0-fill:
post:
tags:
- Editing
summary: FLUX.1 Fill [pro] - inpaint with a mask
operationId: generateFluxFill
requestBody:
required: true
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/GenerationRequest'
- type: object
required:
- image
properties:
image:
type: string
description: Base64-encoded source image.
mask:
type: string
description: Base64-encoded mask image.
responses:
'200':
$ref: '#/components/responses/AsyncResponse'
/v1/flux-pro-1.0-expand:
post:
tags:
- Editing
summary: FLUX.1 Expand [pro] - outpaint
operationId: generateFluxExpand
requestBody:
required: true
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/GenerationRequest'
- type: object
required:
- image
properties:
image:
type: string
description: Base64-encoded source image.
top:
type: integer
bottom:
type: integer
left:
type: integer
right:
type: integer
responses:
'200':
$ref: '#/components/responses/AsyncResponse'
components:
responses:
AsyncResponse:
description: Generation task queued.
content:
application/json:
schema:
$ref: '#/components/schemas/AsyncResponse'
schemas:
AsyncResponse:
type: object
properties:
id:
type: string
polling_url:
type: string
format: uri
GenerationRequest:
type: object
properties:
prompt:
type: string
width:
type: integer
height:
type: integer
aspect_ratio:
type: string
example: '16:9'
seed:
type: integer
prompt_upsampling:
type: boolean
default: false
safety_tolerance:
type: integer
minimum: 0
maximum: 6
output_format:
type: string
enum:
- jpeg
- png
- webp
webhook_url:
type: string
format: uri
webhook_secret:
type: string
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-key
description: BFL API key.
x-provenance:
method: harvested
publisher: Black Forest Labs
source: https://api.bfl.ai/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)