Skip to content

/fal-ai/flux-1/dev

POST https://www.kkiai.com/fal-ai/flux-1/dev

Official documentation: https://fal.ai/models/fal-ai/flux-1/dev

Request Parameters

Authorization

Add the Authorization parameter to the Header, with the value being the Token concatenated after Bearer

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

Body Parameters (application/json)

ParameterTypeRequiredDescription
promptstringRequired
image_sizestringOptionalSize of the generated image. Default value: landscape_4_3 Range (3:4, 4:3, 16:9, 9:16)
num_inference_stepsintegerOptionalNumber of inference steps to perform. Default value: 28 Range: 0-50
guidance_scalenumberOptionalCFG (Classifier-Free Guidance) scale measures how closely you want the model to follow the prompt when searching for relevant images. Default value: 3.5 Range: 1-20
num_imagesintegerOptionalNumber of images to generate. Default value: 1 Range: 1-4
enable_safety_checkerbooleanOptionalIf set to true, enables the safety checker. Default value: true
output_formatstringOptionalFormat of the generated image. Default value: "jpeg" Supported formats: default, JPEG, png
accelerationstringOptionalGeneration speed. Higher speed results in faster generation. Default value: "regular" Supported: default, none, regular, high

Request Example

json
{
  "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.",
  "image_size": "landscape_4_3",
  "num_inference_steps": 28,
  "guidance_scale": 3.5,
  "num_images": 1,
  "enable_safety_checker": true,
  "output_format": "jpeg",
  "acceleration": "regular"
}

cURL Example

bash
curl --location --request POST 'https://www.kkiai.com/fal-ai/flux-1/dev' \
--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.",
  "image_size": "landscape_4_3",
  "num_inference_steps": 28,
  "guidance_scale": 3.5,
  "num_images": 1,
  "enable_safety_checker": true,
  "output_format": "jpeg",
  "acceleration": "regular"
}'

Response

🟢 200 Success

Response Body

ParameterTypeRequiredDescription
statusstringRequired
request_idstringRequired
response_urlstringRequired
status_urlstringRequired
cancel_urlstringRequired
logsnullRequired
metricsobjectRequired
queue_positionintegerRequired

Response Example

json
{
    "status": "IN_QUEUE",
    "request_id": "3892f1e8-5fb1-469f-87b0-696d6054c9f2",
    "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2",
    "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status",
    "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel",
    "logs": null,
    "metrics": {},
    "queue_position": 0
}