GPT Image 2

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

execute_forge({
  "base_model_id": "gpt-image-2",
  "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/openai-gpt-image-2/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

stringrequired

Describe what to generate, or the change to make.

aspect_ratio

enumdefault SQUARE_1K18 options

The shape and size of the output. Auto follows the shape of the input.

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.

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

scene_lighting

any

Where the light comes from, how bright it is and its colour.

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.