Skip to main content
POST
Flux Kontext
Flux Kontext image generation model

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Text description of the image to generate.

aspect_ratio
enum<string>
default:1:1

Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio.

Available options:
1:1,
16:9,
3:2,
2:3,
4:5,
5:4,
9:16,
3:4,
4:3
resolution
enum<string>
default:2K

Resolution of the generated image

Available options:
1K,
2K,
4K
image_urls
string<uri>[]

List of input images for image-to-image generation. Maximum 4 images. Must be jpeg, png, gif, or webp.

n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.