Sign in

v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

Generate or edit images using the Flux Kontext Pro model based on text prompts. <a href='https://docs.bfl.ai/api/tasks/edit-or-create-an-image-with-flux-kontext-pro' target='_blank'>Official documentation</a>

post/bfl/v1/flux-kontext-pro

Request body

promptstring required

Image description. Note: Flux supports multilingual understanding, but English performs best in testing.

input_imagestring

Reference image 1, URL or base64

input_image_2string

Reference image 2, URL or base64

input_image_3string

Reference image 3, URL or base64

input_image_4string

Reference image 4, URL or base64

aspect_ratio'21:9' | '9:21'

Aspect ratio

seedstring

Random seed

output_format'jpeg' | 'png'

Output format

prompt_upsamplingboolean

Whether to enable prompt upsampling. true - yes, false - no

safety_toleranceinteger

Safety tolerance level for input and output adjustment. Range: 0-6, where 0 is strictest and 6 is most permissive. Default: 2

webhook_urlstring

Asynchronous callback URL

Example request

{
  "aspect_ratio": "21:9",
  "output_format": "jpeg"
}

Response

Request successful

statusstring required
messagestring required
dataobject required

Example response

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "jobId"
  }
}