Flux Kontext Pro

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "flux-kontext-pro",
    "input": {
      "prompt": "Make this a 90s cartoon"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

7 fields in input, required first.

• promptRequired
  string

  Text description of what you want to generate, or the instruction on how to edit the given image.

• aspect_ratioOptional
  match_input_image, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2Default match_input_image

  Aspect ratio of the generated image. Use 'match_input_image' to match the aspect ratio of the input image.

• output_formatOptional
  jpg, pngDefault png

  Output format for the generated image

• seedOptional
  integer

  Random seed. Set for reproducible generation

• input_imageOptional
  URL

  Image to use as reference. Must be jpeg, png, gif, or webp.

• safety_toleranceOptional
  integerDefault 2

  Safety tolerance, 0 is most strict and 6 is most permissive. 2 is currently the maximum allowed when input images are used.

• prompt_upsamplingOptional
  booleanDefault false

  Automatic prompt improvement