Flux 2 Dev

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-2-dev",
    "input": {
      "prompt": "Replace the color of the car to blue"
    }
  }'

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

10 fields in input, required first.

• promptRequired
  string

  Text description of the image to generate.

• input_imagesOptional
  arrayDefault

  List of input images for image-to-image generation. Maximum 4 images. Must be jpeg, png, gif, or webp.

• go_fastOptional
  booleanDefault true

  Run faster predictions with additional optimizations.

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

  Aspect ratio for the generated image. Use 'match_input_image' to match the first input image's aspect ratio.

• widthOptional
  integer

  Width of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32).

• heightOptional
  integer

  Height of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32).

• seedOptional
  integer

  Random seed. Set for reproducible generation.

• output_formatOptional
  webp, jpg, pngDefault webp

  Format of the output images.

• output_qualityOptional
  integerDefault 80

  Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for.png outputs.

• disable_safety_checkerOptional
  booleanDefault false

  Disable safety checker for generated images.