GPT Image 2

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",
    "input": {
      "prompt": "A young Indian woman in a yellow t-shirt, smiling and gesturing with her thumb, with th..."
    }
  }'

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

6 fields in input, required first.

• promptRequired
  string

  What to generate

• input_imagesOptional
  arrayDefault

  Optional reference images (logos, screenshots, products)

• qualityOptional
  low, medium, high, autoDefault low

  low is fast and cheap; medium balances; high is slow and pricier

• aspect_ratioOptional
  1:1, 3:2, 2:3, 16:9, 9:16Default 1:1
• backgroundOptional
  auto, transparent, opaqueDefault auto
• output_formatOptional
  png, jpeg, webpDefault png