FLUX.2 [dev]

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

execute_forge({
  "base_model_id": "flux-2-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-2-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_1K10 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.

prompt_enhancement

enumdefault AUTOAUTO, OFF, STANDARD

Let the model rewrite the prompt before generating.

seed

integer

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

guidance_scale

numberdefault 2.50–20

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

inference_steps

integerdefault 284–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

guidance_file_reference_image

file[]

Guides the edit

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.