API reference

/fal-ai/flux-pro/kontext/text-to-image

Official documentation: https://fal.ai/models/fal-ai/flux-pro/kontext/text-to-image

POST/fal-ai/flux-pro/kontext/text-to-image

Body Parametersapplication/json

aspect_ratio string

The aspect ratio of the generated image. Default value: "1:1" Support: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21

guidance_scale number

The CFG (Classifier Free Guidance) scale is a measure of how closely you want the model to follow the cues when finding relevant images. Default value: 3.5 Range value 1-20

num_images integer

The number of images generated. Default value: 1 Range value 1-4

output_format string

The format of the generated image. Default value: "jpeg" supports default, png, jpeg

prompt* string

Tips for generating images.

safety_tolerance string

The safety tolerance level of the generated image. 1 is the strictest and 5 is the loosest. Default value: "2"

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

2"aspect_ratio": "1:1",

3"guidance_scale": 3.5,

4"num_images": 1,

5"output_format": "jpeg",

6"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",

7"safety_tolerance": "2"

Code Sample cURL

1curl -X POST "https://api.digislash.com/fal-ai/flux-pro/kontext/text-to-image" \

2-H "Authorization: Bearer <API Key>" \

3-H "Content-Type: application/json" \

4-d '{

5"aspect_ratio": "1:1",

6"guidance_scale": 3.5,

7"num_images": 1,

8"output_format": "jpeg",

9"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",

10"safety_tolerance": "2"

11}'

Response

1▼{

2"cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",

3"logs": [],

4"metrics": {},

5"queue_position": 0,

6"request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",

7"response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",

8"status": "IN_QUEUE",

9"status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status"

10}