FLUX.1 Kontext [dev]

https://mcp.app.layer.ai/mcp

execute_forge({
  "base_model_id": "flux-kontext-dev",
  "prompt": "A crystal sword icon on a transparent background, game UI art",
  "batch_size": 4,
  "width": 1024,
  "height": 1024
})

# Start the generation — returns an inference id straight away.
curl -X POST https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/base-models/bfl-flux-1-kontext-dev/inferences \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "A crystal sword icon on a transparent background, game UI art"
      }'

# Poll until status is "complete" — the response then carries the asset URLs.
curl https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/inferences/$INFERENCE_ID \
  -H "Authorization: Bearer $LAYER_TOKEN"

prompt

string

Describe what to generate, or the change to make.

aspect_ratio

enumdefault SQUARE_1K14 options

The shape and size of the output.

quality

enumdefault HIGHLOW, MEDIUM, HIGH

Higher levels render more detail, and can take longer and cost more.

seed

integer

The starting point for the model's randomness. The same seed and settings give the same result.

guidance_scale

numberdefault 2.51–20

How closely the result follows the prompt. Lower gives the model more freedom.

inference_steps

integerdefault 2810–50

How many refinement passes the model makes. More add detail and take longer.

transparency

booleandefault false

Output the subject alone, with no backdrop behind it.

guidance_file_init_image

file[]

The image to modify

output_fit

any

Trim the transparent margin, and place the image on a canvas of a fixed size.

prompt_language

string

The language the prompt is written in, so it reaches the model as you meant it.