---
title: "POST /bfl/v1/flux-dev"
method: POST
path: "/bfl/v1/flux-dev"
---

# POST /bfl/v1/flux-dev

`POST /bfl/v1/flux-dev`

Generate or edit images using the Flux Dev model based on text prompts. <a href='https://docs.bfl.ai/api/tasks/generate-an-image-with-flux1-[pro]' target='_blank'>Official documentation</a>

## Request body

- DevRequest
  - `prompt` string, required — Image description. Note: Flux supports multilingual understanding, but English performs best in testing.
  - `image_prompt` string — Reference image, base64 encoded
  - `width` string — Width of generated image. Range: 256-1440, must be a multiple of 32. Default: 1024
  - `height` string — Height of generated image. Range: 256-1440, must be a multiple of 32. Default: 768
  - `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
  - `steps` integer — Number of steps in image generation process. Range: 1-50. Default: 40
  - `guidance` number — Guidance scale for image generation. Higher guidance increases prompt adherence at the cost of realism. Range: 1.5-5. Default: 2.5
  - `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)