Nano Banana 2.1

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": "nano-banana-21-edit",
    "input": {
      "prompt": "A red fox running through fresh snow at sunrise",
      "images": "https://example.com/photo.jpg"
    }
  }'

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.

• imagesRequired
  array

  List of URLs of input images for editing. The maximum number of images is 14.

• promptRequired
  string

  The positive prompt for the generation.

• resolutionOptional
  1k, 2k, 4kDefault 1k

  The resolution of the output image.

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

  The aspect ratio of the generated media.

• output_formatOptional
  png, jpegDefault png

  The format of the output image.

• enable_web_searchOptional
  booleanDefault false

  If enabled, the model will use web search to enhance the generation with real-time information.

• enable_image_searchOptional
  booleanDefault false

  If enabled, the model will use image search to enhance the generation with real-time information.