FLUX.1 Kontext [pro]

flux_kontext_pro

FLUX.1 Kontext [pro] provides context-aware image generation with professional capabilities and enhanced complex prompt understanding.

Endpoints

POST /v1/queue/flux_kontext_pro # Create task

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

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

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

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro" \
  --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 description of the desired image.

input_image string

Base64-encoded image or image URL used as a reference. Supports up to 20MB.

input_image_2 string

Base64-encoded image or image URL used as a reference. Supports up to 20MB.

input_image_3 string

Base64-encoded image or image URL used as a reference. Supports up to 20MB.

input_image_4 string

Base64-encoded image or image URL used as a reference. Supports up to 20MB.

seed int

Used for reproducibility. If null or omitted, a random seed is used. Accepts any integer, for example 42.

aspect_ratio string

Image aspect ratio, between 21:9 and 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 upsample the prompt. When enabled, the prompt is automatically modified for more creative generation.

Default: false

safety_tolerance any

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_pro/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro/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