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

POST https://www.kkiai.com/fal-ai/flux-pro/kontext/text-to-image

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

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Body Parameters (application/json)

Parameter	Type	Required	Description
prompt	string	Required
guidance_scale	number	Optional	CFG (Classifier-Free Guidance) scale used to measure how closely you want the model to adhere to the prompt when searching for relevant images. Default: 3.5 Range: 1-20
num_images	integer	Optional	Number of images to generate. Default: 1 Range: 1-4
output_format	string	Optional	Format of generated images. Default: "jpeg" Supported: default, png, jpeg
safety_tolerance	string	Optional	Safety tolerance level for generated images. 1 is most strict, 5 is most lenient. Default: "2"
aspect_ratio	string	Optional	Aspect ratio of generated images. Default: "1:1" Supported: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21

Request Example

{
  "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.",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "safety_tolerance": "2",
  "aspect_ratio": "1:1"
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/fal-ai/flux-pro/kontext/text-to-image' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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.",
  "guidance_scale": 3.5,
  "num_images": 1,
  "output_format": "jpeg",
  "safety_tolerance": "2",
  "aspect_ratio": "1:1"
}'

Response

🟢 200 Success

Response Example

{
    "status": "IN_QUEUE",
    "request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
    "response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
    "status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status",
    "cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
    "logs": null,
    "metrics": {},
    "queue_position": 0
}