Docs Fal.ai /fal-ai/flux-pro/kontext/max
API reference

/fal-ai/flux-pro/kontext/max

Official documentation: https://fal.ai/models/fal-ai/flux-pro/kontext/max

POST/fal-ai/flux-pro/kontext/max

Body Parametersapplication/json

aspect_ratio string

Image size, enumeration values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21

guidance_scale number

Range value: 1-20

image_url* string

Image URL

num_images integer

Number of output pictures, range value: 1-4

output_format* string

Image output format: "jpeg", "png"

prompt* string

prompt word

safety_tolerance string

safety tolerance

seed integer

Random seed; same seed makes results reproducible

sync_mode boolean

synchronous mode

Responses

200 application/json
response-200 object
400 Bad request or validation failed application/json
response-400 object
properties
error* object
401 Missing or invalid API Key application/json
response-401 object
Request Body Example
1{
2"aspect_ratio": "string",
3"guidance_scale": 3.5,
4"image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
5"num_images": 1,
6"output_format": "jpeg",
7"prompt": "Put a donut next to the flour.",
8"safety_tolerance": "2",
9"seed": 0,
10"sync_mode": false
11}
Code Sample cURL
1curl -X POST "https://api.digislash.com/fal-ai/flux-pro/kontext/max" \
2-H "Authorization: Bearer <API Key>" \
3-H "Content-Type: application/json" \
4-d '{
5"aspect_ratio": "string",
6"guidance_scale": 3.5,
7"image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png",
8"num_images": 1,
9"output_format": "jpeg",
10"prompt": "Put a donut next to the flour.",
11"safety_tolerance": "2",
12"seed": 0,
13"sync_mode": false
14}'
Response
1▼{
2"cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a/cancel",
3"logs": [],
4"metrics": {},
5"queue_position": 0,
6"request_id": "e36fc67f-afa7-416a-a288-50d90a630d7a",
7"response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a",
8"status": "IN_QUEUE",
9"status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a/status"
10}