FLUX.1 Kontext [max]

flux_kontext_max

FLUX.1 Kontext [max] provides maximum context understanding and image generation capability for complex creative tasks.

Endpoints

POST /v1/queue/flux_kontext_max # Create task

GET /v1/queue/flux_kontext_max/requests/{request_id}/status # Check status

GET /v1/queue/flux_kontext_max/requests/{request_id}/response # Get result

PUT /v1/queue/flux_kontext_max/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red apple on a white table, soft studio lighting.",
    "seed": 42,
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_upsampling": false,
    "safety_tolerance": 2
  }'

prompt string required

Text prompt describing the image to generate or edit.

input_image string

First input image. Supports Base64-encoded image data or a URL.

input_image_2 string

Second input image. Supports Base64-encoded image data or a URL.

input_image_3 string

Third input image. Supports Base64-encoded image data or a URL.

input_image_4 string

Fourth input image. Supports Base64-encoded image data or a URL.

seed int

Random seed used for reproducible generation, for example 42.

aspect_ratio string

Image aspect ratio, such as 16:9.

Range: 21:9 - 9:21

output_format string

Output format. jpeg is accepted, but the returned file may still be png.

Options: jpeg, png

Default: png

prompt_upsampling bool

Whether to enable automatic prompt enhancement. When enabled, the prompt is automatically modified for more creative generation.

Default: false

safety_tolerance int

Safety tolerance level for input and output moderation. 0 is the strictest and 6 is the most permissive.

Range: 0 <= x <= 6

Default: 2

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling