GPT Image 2.5 Sunburst Edit

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": "gpt-image-2-5-sunburst-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

8 fields in input, required first.

• imagesRequired
  array

  List of URLs of input images for editing.

• promptRequired
  string

  The positive prompt for the generation.

• qualityOptional
  low, medium, high, xhigh, maxDefault medium

  Rendering quality tier. Higher tiers add detail and cost more: low is the fastest draft tier, medium is the balanced default, high and xhigh add fidelity, max is the highest-fidelity tier.

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

  The resolution of the output image.

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

  The aspect ratio of the generated image. Auto-detected from input image if not specified.

• output_formatOptional
  png, jpeg, webpDefault png

  The format of the output image.

• enable_sync_modeOptional
  booleanDefault false

  If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models.

• enable_base64_outputOptional
  booleanDefault false

  If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN.