---
title: "POST /bfl/v1/flux-kontext-pro"
method: POST
path: "/bfl/v1/flux-kontext-pro"
---

# POST /bfl/v1/flux-kontext-pro

`POST /bfl/v1/flux-kontext-pro`

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>

## Request body

- KontextMaxRequest — Generate or edit images using the Flux Kontext Max model based on text prompts. <a href="https://docs.bfl.ai/api/tasks/edit-or-create-an-image-with-flux-kontext-max" target="_self">Official documentation</a>
  - `prompt` string, required — Image description. Note: Flux supports multilingual understanding, but English performs best in testing.
  - `input_image` string — Reference image 1, URL or base64
  - `input_image_2` string — Reference image 2, URL or base64
  - `input_image_3` string — Reference image 3, URL or base64
  - `input_image_4` string — Reference image 4, URL or base64
  - `aspect_ratio` '21:9' | '9:21' — Aspect ratio
  - `seed` string — Random seed
  - `output_format` 'jpeg' | 'png' — Output format
  - `prompt_upsampling` boolean — Whether to enable prompt upsampling. true - yes, false - no
  - `safety_tolerance` integer — Safety tolerance level for input and output adjustment. Range: 0-6, where 0 is strictest and 6 is most permissive. Default: 2
  - `webhook_url` string — Asynchronous callback URL

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)