PopNowAPI Docs
Main content

GPT Image 2.5 Sunburst API reference

OpenAI's quality-first model, up to 4K with clean text

Call GPT Image 2.5 Sunburst from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in credits, and a request you can paste into a terminal.

At a glance

Made by
OpenAI
Output
Image
From
0.27 credits per image ($0.0027)
Typical time
about 66 s

1 credit = $0.01. A task holds the highest possible charge when it is accepted and settles the real amount when it finishes, rounded up to whole credits; failed tasks are not charged. Ask POST /api/v1/jobs/quote for the exact figure before you run.

Create Image

openai/gpt-image-2.5-sunburst/text-to-image

Price

OptionCredits (per image)US dollars
aspect_ratio = 1:3, quality = low, resolution = 1k0.27$0.0027
aspect_ratio = 3:1, quality = low, resolution = 1k0.27$0.0027
aspect_ratio = 21:9, quality = low, resolution = 1k0.37$0.0037
aspect_ratio = 9:21, quality = low, resolution = 1k0.37$0.0037
aspect_ratio = 1:2, quality = low, resolution = 1k0.41$0.0041
aspect_ratio = 2:1, quality = low, resolution = 1k0.41$0.0041
aspect_ratio = 1:3, quality = low, resolution = 2k0.43$0.0043
aspect_ratio = 3:1, quality = low, resolution = 2k0.43$0.0043
aspect_ratio = 16:9, quality = low, resolution = 1k0.46$0.0046
aspect_ratio = 9:16, quality = low, resolution = 1k0.46$0.0046
aspect_ratio = 2:3, quality = low, resolution = 1k0.54$0.0054
aspect_ratio = 3:2, quality = low, resolution = 1k0.54$0.0054
aspect_ratio = 1:3, quality = low, resolution = 4k0.56$0.0056
aspect_ratio = 3:1, quality = low, resolution = 4k0.56$0.0056
aspect_ratio = 1:3, quality = medium, resolution = 1k0.57$0.0057
aspect_ratio = 3:1, quality = medium, resolution = 1k0.57$0.0057
aspect_ratio = 3:4, quality = low, resolution = 1k0.58$0.0058
aspect_ratio = 4:3, quality = low, resolution = 1k0.58$0.0058
aspect_ratio = 4:5, quality = low, resolution = 1k0.63$0.0063
aspect_ratio = 5:4, quality = low, resolution = 1k0.63$0.0063
aspect_ratio = 21:9, quality = low, resolution = 2k0.67$0.0067
aspect_ratio = 9:21, quality = low, resolution = 2k0.67$0.0067
aspect_ratio = 21:9, quality = medium, resolution = 1k0.71$0.0071
aspect_ratio = 9:21, quality = medium, resolution = 1k0.71$0.0071
aspect_ratio = 1:1, quality = low, resolution = 1k0.77$0.0077
aspect_ratio = 1:2, quality = low, resolution = 2k0.77$0.0077
aspect_ratio = 2:1, quality = low, resolution = 2k0.77$0.0077
aspect_ratio = 1:2, quality = medium, resolution = 1k0.85$0.0085
aspect_ratio = 2:1, quality = medium, resolution = 1k0.85$0.0085
aspect_ratio = 16:9, quality = low, resolution = 2k0.86$0.0086
aspect_ratio = 9:16, quality = low, resolution = 2k0.86$0.0086
aspect_ratio = 21:9, quality = low, resolution = 4k0.9$0.009
aspect_ratio = 9:21, quality = low, resolution = 4k0.9$0.009
aspect_ratio = 1:3, quality = medium, resolution = 2k0.95$0.0095
aspect_ratio = 3:1, quality = medium, resolution = 2k0.95$0.0095
aspect_ratio = 16:9, quality = medium, resolution = 1k0.98$0.0098
aspect_ratio = 9:16, quality = medium, resolution = 1k0.98$0.0098
aspect_ratio = 2:3, quality = low, resolution = 2k1.01$0.0101
aspect_ratio = 3:2, quality = low, resolution = 2k1.01$0.0101
aspect_ratio = 2:3, quality = medium, resolution = 1k1.1$0.011
aspect_ratio = 3:2, quality = medium, resolution = 1k1.1$0.011
aspect_ratio = 3:4, quality = low, resolution = 2k1.1$0.011
aspect_ratio = 4:3, quality = low, resolution = 2k1.1$0.011
aspect_ratio = 1:2, quality = low, resolution = 4k1.14$0.0114
aspect_ratio = 2:1, quality = low, resolution = 4k1.14$0.0114
aspect_ratio = 4:5, quality = low, resolution = 2k1.22$0.0122
aspect_ratio = 5:4, quality = low, resolution = 2k1.22$0.0122
aspect_ratio = 3:4, quality = medium, resolution = 1k1.23$0.0123
aspect_ratio = 4:3, quality = medium, resolution = 1k1.23$0.0123
aspect_ratio = 1:3, quality = medium, resolution = 4k1.26$0.0126
aspect_ratio = 3:1, quality = medium, resolution = 4k1.26$0.0126
aspect_ratio = 4:5, quality = medium, resolution = 1k1.31$0.0131
aspect_ratio = 5:4, quality = medium, resolution = 1k1.31$0.0131
aspect_ratio = 21:9, quality = medium, resolution = 2k1.36$0.0136
aspect_ratio = 9:21, quality = medium, resolution = 2k1.36$0.0136
aspect_ratio = 16:9, quality = low, resolution = 4k1.4$0.014
aspect_ratio = 9:16, quality = low, resolution = 4k1.4$0.014
aspect_ratio = 1:1, quality = low, resolution = 2k1.49$0.0149
aspect_ratio = 1:1, quality = medium, resolution = 1k1.64$0.0164
aspect_ratio = 1:2, quality = medium, resolution = 2k1.66$0.0166
aspect_ratio = 2:1, quality = medium, resolution = 2k1.66$0.0166
aspect_ratio = 2:3, quality = low, resolution = 4k1.68$0.0168
aspect_ratio = 3:2, quality = low, resolution = 4k1.68$0.0168
aspect_ratio = 3:4, quality = low, resolution = 4k1.79$0.0179
aspect_ratio = 4:3, quality = low, resolution = 4k1.79$0.0179
aspect_ratio = 21:9, quality = medium, resolution = 4k1.86$0.0186
aspect_ratio = 9:21, quality = medium, resolution = 4k1.86$0.0186
aspect_ratio = 16:9, quality = medium, resolution = 2k1.91$0.0191
aspect_ratio = 9:16, quality = medium, resolution = 2k1.91$0.0191
aspect_ratio = 4:5, quality = low, resolution = 4k1.99$0.0199
aspect_ratio = 5:4, quality = low, resolution = 4k1.99$0.0199
aspect_ratio = 1:3, quality = high, resolution = 1k2.09$0.0209
aspect_ratio = 3:1, quality = high, resolution = 1k2.09$0.0209
aspect_ratio = 2:3, quality = medium, resolution = 2k2.13$0.0213
aspect_ratio = 3:2, quality = medium, resolution = 2k2.13$0.0213
aspect_ratio = 3:4, quality = medium, resolution = 2k2.39$0.0239
aspect_ratio = 4:3, quality = medium, resolution = 2k2.39$0.0239
aspect_ratio = 1:1, quality = low, resolution = 4k2.43$0.0243
aspect_ratio = 1:2, quality = medium, resolution = 4k2.49$0.0249
aspect_ratio = 2:1, quality = medium, resolution = 4k2.49$0.0249
aspect_ratio = 4:5, quality = medium, resolution = 2k2.59$0.0259
aspect_ratio = 5:4, quality = medium, resolution = 2k2.59$0.0259
aspect_ratio = 21:9, quality = high, resolution = 1k2.79$0.0279
aspect_ratio = 9:21, quality = high, resolution = 1k2.79$0.0279
aspect_ratio = 16:9, quality = high, resolution = 1k3.6$0.036
aspect_ratio = 9:16, quality = high, resolution = 1k3.6$0.036
aspect_ratio = 16:9, quality = medium, resolution = 4k3.17$0.0317
aspect_ratio = 9:16, quality = medium, resolution = 4k3.17$0.0317
aspect_ratio = 1:2, quality = high, resolution = 1k3.22$0.0322
aspect_ratio = 2:1, quality = high, resolution = 1k3.22$0.0322
aspect_ratio = 1:1, quality = medium, resolution = 2k3.27$0.0327
aspect_ratio = 2:3, quality = high, resolution = 1k4.2$0.042
aspect_ratio = 3:2, quality = high, resolution = 1k4.2$0.042
aspect_ratio = 3:4, quality = high, resolution = 1k4.72$0.0472
aspect_ratio = 4:3, quality = high, resolution = 1k4.72$0.0472
aspect_ratio = 2:3, quality = medium, resolution = 4k3.58$0.0358
aspect_ratio = 3:2, quality = medium, resolution = 4k3.58$0.0358
aspect_ratio = 1:3, quality = high, resolution = 2k3.62$0.0362
aspect_ratio = 3:1, quality = high, resolution = 2k3.62$0.0362
aspect_ratio = 1:3, quality = xhigh, resolution = 1k3.62$0.0362
aspect_ratio = 3:1, quality = xhigh, resolution = 1k3.62$0.0362
aspect_ratio = 1:1, quality = high, resolution = 1k6.38$0.0638
aspect_ratio = 3:4, quality = medium, resolution = 4k3.94$0.0394
aspect_ratio = 4:3, quality = medium, resolution = 4k3.94$0.0394
aspect_ratio = 4:5, quality = medium, resolution = 4k4.28$0.0428
aspect_ratio = 5:4, quality = medium, resolution = 4k4.28$0.0428
aspect_ratio = 21:9, quality = xhigh, resolution = 1k4.74$0.0474
aspect_ratio = 9:21, quality = xhigh, resolution = 1k4.74$0.0474
aspect_ratio = 1:3, quality = high, resolution = 4k4.84$0.0484
aspect_ratio = 3:1, quality = high, resolution = 4k4.84$0.0484
aspect_ratio = 4:5, quality = high, resolution = 1k5.18$0.0518
aspect_ratio = 5:4, quality = high, resolution = 1k5.18$0.0518
aspect_ratio = 1:1, quality = medium, resolution = 4k5.4$0.054
aspect_ratio = 21:9, quality = high, resolution = 2k5.53$0.0553
aspect_ratio = 9:21, quality = high, resolution = 2k5.53$0.0553
aspect_ratio = 1:2, quality = xhigh, resolution = 1k5.68$0.0568
aspect_ratio = 2:1, quality = xhigh, resolution = 1k5.68$0.0568
aspect_ratio = 1:3, quality = xhigh, resolution = 2k6.28$0.0628
aspect_ratio = 3:1, quality = xhigh, resolution = 2k6.28$0.0628
aspect_ratio = 1:2, quality = high, resolution = 2k6.46$0.0646
aspect_ratio = 2:1, quality = high, resolution = 2k6.46$0.0646
aspect_ratio = 16:9, quality = xhigh, resolution = 1k6.53$0.0653
aspect_ratio = 9:16, quality = xhigh, resolution = 1k6.53$0.0653
aspect_ratio = 16:9, quality = high, resolution = 2k7.21$0.0721
aspect_ratio = 9:16, quality = high, resolution = 2k7.21$0.0721
aspect_ratio = 2:3, quality = xhigh, resolution = 1k7.47$0.0747
aspect_ratio = 3:2, quality = xhigh, resolution = 1k7.47$0.0747
aspect_ratio = 21:9, quality = high, resolution = 4k7.62$0.0762
aspect_ratio = 9:21, quality = high, resolution = 4k7.62$0.0762
aspect_ratio = 1:3, quality = max, resolution = 1k8.19$0.0819
aspect_ratio = 3:1, quality = max, resolution = 1k8.19$0.0819
aspect_ratio = 2:3, quality = high, resolution = 2k8.31$0.0831
aspect_ratio = 3:2, quality = high, resolution = 2k8.31$0.0831
aspect_ratio = 3:4, quality = xhigh, resolution = 1k8.34$0.0834
aspect_ratio = 4:3, quality = xhigh, resolution = 1k8.34$0.0834
aspect_ratio = 1:3, quality = xhigh, resolution = 4k8.43$0.0843
aspect_ratio = 3:1, quality = xhigh, resolution = 4k8.43$0.0843
aspect_ratio = 4:5, quality = xhigh, resolution = 1k8.98$0.0898
aspect_ratio = 5:4, quality = xhigh, resolution = 1k8.98$0.0898
aspect_ratio = 3:4, quality = high, resolution = 2k9.36$0.0936
aspect_ratio = 4:3, quality = high, resolution = 2k9.36$0.0936
aspect_ratio = 21:9, quality = xhigh, resolution = 2k9.44$0.0944
aspect_ratio = 9:21, quality = xhigh, resolution = 2k9.44$0.0944
aspect_ratio = 1:2, quality = high, resolution = 4k9.78$0.0978
aspect_ratio = 2:1, quality = high, resolution = 4k9.78$0.0978
aspect_ratio = 4:5, quality = high, resolution = 2k10.2$0.102
aspect_ratio = 5:4, quality = high, resolution = 2k10.2$0.102
aspect_ratio = 21:9, quality = max, resolution = 1k10.72$0.1072
aspect_ratio = 9:21, quality = max, resolution = 1k10.72$0.1072
aspect_ratio = 1:1, quality = xhigh, resolution = 1k11.3$0.113
aspect_ratio = 1:2, quality = xhigh, resolution = 2k11.44$0.1144
aspect_ratio = 2:1, quality = xhigh, resolution = 2k11.44$0.1144
aspect_ratio = 16:9, quality = high, resolution = 4k12.07$0.1207
aspect_ratio = 9:16, quality = high, resolution = 4k12.07$0.1207
aspect_ratio = 1:2, quality = max, resolution = 1k12.44$0.1244
aspect_ratio = 2:1, quality = max, resolution = 1k12.44$0.1244
aspect_ratio = 1:1, quality = high, resolution = 2k12.9$0.129
aspect_ratio = 21:9, quality = xhigh, resolution = 4k13.01$0.1301
aspect_ratio = 9:21, quality = xhigh, resolution = 4k13.01$0.1301
aspect_ratio = 16:9, quality = xhigh, resolution = 2k13.12$0.1312
aspect_ratio = 9:16, quality = xhigh, resolution = 2k13.12$0.1312
aspect_ratio = 2:3, quality = high, resolution = 4k14.14$0.1414
aspect_ratio = 3:2, quality = high, resolution = 4k14.14$0.1414
aspect_ratio = 1:3, quality = max, resolution = 2k14.29$0.1429
aspect_ratio = 3:1, quality = max, resolution = 2k14.29$0.1429
aspect_ratio = 16:9, quality = max, resolution = 1k14.47$0.1447
aspect_ratio = 9:16, quality = max, resolution = 1k14.47$0.1447
aspect_ratio = 2:3, quality = xhigh, resolution = 2k14.85$0.1485
aspect_ratio = 3:2, quality = xhigh, resolution = 2k14.85$0.1485
aspect_ratio = 3:4, quality = high, resolution = 4k15.6$0.156
aspect_ratio = 4:3, quality = high, resolution = 4k15.6$0.156
aspect_ratio = 3:4, quality = xhigh, resolution = 2k16.6$0.166
aspect_ratio = 4:3, quality = xhigh, resolution = 2k16.6$0.166
aspect_ratio = 2:3, quality = max, resolution = 1k16.61$0.1661
aspect_ratio = 3:2, quality = max, resolution = 1k16.61$0.1661
aspect_ratio = 4:5, quality = high, resolution = 4k16.94$0.1694
aspect_ratio = 5:4, quality = high, resolution = 4k16.94$0.1694
aspect_ratio = 1:2, quality = xhigh, resolution = 4k17.34$0.1734
aspect_ratio = 2:1, quality = xhigh, resolution = 4k17.34$0.1734
aspect_ratio = 4:5, quality = xhigh, resolution = 2k18.2$0.182
aspect_ratio = 5:4, quality = xhigh, resolution = 2k18.2$0.182
aspect_ratio = 3:4, quality = max, resolution = 1k18.69$0.1869
aspect_ratio = 4:3, quality = max, resolution = 1k18.69$0.1869
aspect_ratio = 1:3, quality = max, resolution = 4k19.18$0.1918
aspect_ratio = 3:1, quality = max, resolution = 4k19.18$0.1918
aspect_ratio = 4:5, quality = max, resolution = 1k20.26$0.2026
aspect_ratio = 5:4, quality = max, resolution = 1k20.26$0.2026
aspect_ratio = 1:1, quality = high, resolution = 4k21.41$0.2141
aspect_ratio = 16:9, quality = xhigh, resolution = 4k21.41$0.2141
aspect_ratio = 9:16, quality = xhigh, resolution = 4k21.41$0.2141
aspect_ratio = 21:9, quality = max, resolution = 2k21.42$0.2142
aspect_ratio = 9:21, quality = max, resolution = 2k21.42$0.2142
aspect_ratio = 1:1, quality = xhigh, resolution = 2k22.89$0.2289
aspect_ratio = 2:3, quality = xhigh, resolution = 4k25.29$0.2529
aspect_ratio = 3:2, quality = xhigh, resolution = 4k25.29$0.2529
aspect_ratio = 1:1, quality = max, resolution = 1k25.35$0.2535
aspect_ratio = 1:2, quality = max, resolution = 2k25.65$0.2565
aspect_ratio = 2:1, quality = max, resolution = 2k25.65$0.2565
aspect_ratio = 3:4, quality = xhigh, resolution = 4k27.68$0.2768
aspect_ratio = 4:3, quality = xhigh, resolution = 4k27.68$0.2768
aspect_ratio = 16:9, quality = max, resolution = 2k29.18$0.2918
aspect_ratio = 9:16, quality = max, resolution = 2k29.18$0.2918
aspect_ratio = 21:9, quality = max, resolution = 4k29.57$0.2957
aspect_ratio = 9:21, quality = max, resolution = 4k29.57$0.2957
aspect_ratio = 4:5, quality = xhigh, resolution = 4k30.27$0.3027
aspect_ratio = 5:4, quality = xhigh, resolution = 4k30.27$0.3027
aspect_ratio = 2:3, quality = max, resolution = 2k33.07$0.3307
aspect_ratio = 3:2, quality = max, resolution = 2k33.07$0.3307
aspect_ratio = 3:4, quality = max, resolution = 2k37.27$0.3727
aspect_ratio = 4:3, quality = max, resolution = 2k37.27$0.3727
aspect_ratio = 1:1, quality = xhigh, resolution = 4k38.01$0.3801
aspect_ratio = 1:2, quality = max, resolution = 4k38.93$0.3893
aspect_ratio = 2:1, quality = max, resolution = 4k38.93$0.3893
aspect_ratio = 4:5, quality = max, resolution = 2k41.13$0.4113
aspect_ratio = 5:4, quality = max, resolution = 2k41.13$0.4113
aspect_ratio = 16:9, quality = max, resolution = 4k48.09$0.4809
aspect_ratio = 9:16, quality = max, resolution = 4k48.09$0.4809
aspect_ratio = 1:1, quality = max, resolution = 2k51.44$0.5144
aspect_ratio = 2:3, quality = max, resolution = 4k56.38$0.5638
aspect_ratio = 3:2, quality = max, resolution = 4k56.38$0.5638
aspect_ratio = 3:4, quality = max, resolution = 4k62.21$0.6221
aspect_ratio = 4:3, quality = max, resolution = 4k62.21$0.6221
aspect_ratio = 4:5, quality = max, resolution = 4k68.48$0.6848
aspect_ratio = 5:4, quality = max, resolution = 4k68.48$0.6848
aspect_ratio = 1:1, quality = max, resolution = 4k85.45$0.8545

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersDescribe the image you want.
aspect_ratioOptionalstring1:11:1, 1:2, 1:3, 2:1, 2:3, 3:1, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 9:21, 16:9, … (+1)Output aspect ratio.
resolutionOptionalstring1k1k, 2k, 4kOutput size tier.
qualityOptionalstringhighlow, medium, high, xhigh, maxRendering quality. Higher tiers add detail, time and cost.
num_outputsOptionalinteger11 to 10How many images to return, each billed separately.
output_formatOptionalstringpngpng, jpeg, webpFile format of the returned images.
output_qualityOptionalinteger—0 to 100Compression quality for JPEG and WebP, from 0 to 100.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "openai/gpt-image-2.5-sunburst/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "num_outputs": 1,
    "quality": "high",
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Edit Image

openai/gpt-image-2.5-sunburst/edit

Price

OptionCredits (per image)US dollars
aspect_ratio = 1:3, quality = low, resolution = 1k0.27$0.0027
aspect_ratio = 3:1, quality = low, resolution = 1k0.27$0.0027
aspect_ratio = 21:9, quality = low, resolution = 1k0.37$0.0037
aspect_ratio = 9:21, quality = low, resolution = 1k0.37$0.0037
aspect_ratio = 1:2, quality = low, resolution = 1k0.41$0.0041
aspect_ratio = 2:1, quality = low, resolution = 1k0.41$0.0041
aspect_ratio = 1:3, quality = low, resolution = 2k0.43$0.0043
aspect_ratio = 3:1, quality = low, resolution = 2k0.43$0.0043
aspect_ratio = 16:9, quality = low, resolution = 1k0.46$0.0046
aspect_ratio = 9:16, quality = low, resolution = 1k0.46$0.0046
aspect_ratio = 2:3, quality = low, resolution = 1k0.54$0.0054
aspect_ratio = 3:2, quality = low, resolution = 1k0.54$0.0054
aspect_ratio = 1:3, quality = low, resolution = 4k0.56$0.0056
aspect_ratio = 3:1, quality = low, resolution = 4k0.56$0.0056
aspect_ratio = 1:3, quality = medium, resolution = 1k0.57$0.0057
aspect_ratio = 3:1, quality = medium, resolution = 1k0.57$0.0057
aspect_ratio = 3:4, quality = low, resolution = 1k0.58$0.0058
aspect_ratio = 4:3, quality = low, resolution = 1k0.58$0.0058
aspect_ratio = 4:5, quality = low, resolution = 1k0.63$0.0063
aspect_ratio = 5:4, quality = low, resolution = 1k0.63$0.0063
aspect_ratio = 21:9, quality = low, resolution = 2k0.67$0.0067
aspect_ratio = 9:21, quality = low, resolution = 2k0.67$0.0067
aspect_ratio = 21:9, quality = medium, resolution = 1k0.71$0.0071
aspect_ratio = 9:21, quality = medium, resolution = 1k0.71$0.0071
aspect_ratio = 1:1, quality = low, resolution = 1k0.77$0.0077
aspect_ratio = 1:2, quality = low, resolution = 2k0.77$0.0077
aspect_ratio = 2:1, quality = low, resolution = 2k0.77$0.0077
aspect_ratio = 1:2, quality = medium, resolution = 1k0.85$0.0085
aspect_ratio = 2:1, quality = medium, resolution = 1k0.85$0.0085
aspect_ratio = 16:9, quality = low, resolution = 2k0.86$0.0086
aspect_ratio = 9:16, quality = low, resolution = 2k0.86$0.0086
aspect_ratio = 21:9, quality = low, resolution = 4k0.9$0.009
aspect_ratio = 9:21, quality = low, resolution = 4k0.9$0.009
aspect_ratio = 1:3, quality = medium, resolution = 2k0.95$0.0095
aspect_ratio = 3:1, quality = medium, resolution = 2k0.95$0.0095
aspect_ratio = 16:9, quality = medium, resolution = 1k0.98$0.0098
aspect_ratio = 9:16, quality = medium, resolution = 1k0.98$0.0098
aspect_ratio = 2:3, quality = low, resolution = 2k1.01$0.0101
aspect_ratio = 3:2, quality = low, resolution = 2k1.01$0.0101
aspect_ratio = 2:3, quality = medium, resolution = 1k1.1$0.011
aspect_ratio = 3:2, quality = medium, resolution = 1k1.1$0.011
aspect_ratio = 3:4, quality = low, resolution = 2k1.1$0.011
aspect_ratio = 4:3, quality = low, resolution = 2k1.1$0.011
aspect_ratio = 1:2, quality = low, resolution = 4k1.14$0.0114
aspect_ratio = 2:1, quality = low, resolution = 4k1.14$0.0114
aspect_ratio = 4:5, quality = low, resolution = 2k1.22$0.0122
aspect_ratio = 5:4, quality = low, resolution = 2k1.22$0.0122
aspect_ratio = 3:4, quality = medium, resolution = 1k1.23$0.0123
aspect_ratio = 4:3, quality = medium, resolution = 1k1.23$0.0123
aspect_ratio = 1:3, quality = medium, resolution = 4k1.26$0.0126
aspect_ratio = 3:1, quality = medium, resolution = 4k1.26$0.0126
aspect_ratio = 4:5, quality = medium, resolution = 1k1.31$0.0131
aspect_ratio = 5:4, quality = medium, resolution = 1k1.31$0.0131
aspect_ratio = 21:9, quality = medium, resolution = 2k1.36$0.0136
aspect_ratio = 9:21, quality = medium, resolution = 2k1.36$0.0136
aspect_ratio = 16:9, quality = low, resolution = 4k1.4$0.014
aspect_ratio = 9:16, quality = low, resolution = 4k1.4$0.014
aspect_ratio = 1:1, quality = low, resolution = 2k1.49$0.0149
aspect_ratio = 1:1, quality = medium, resolution = 1k1.64$0.0164
aspect_ratio = 1:2, quality = medium, resolution = 2k1.66$0.0166
aspect_ratio = 2:1, quality = medium, resolution = 2k1.66$0.0166
aspect_ratio = 2:3, quality = low, resolution = 4k1.68$0.0168
aspect_ratio = 3:2, quality = low, resolution = 4k1.68$0.0168
aspect_ratio = 3:4, quality = low, resolution = 4k1.79$0.0179
aspect_ratio = 4:3, quality = low, resolution = 4k1.79$0.0179
aspect_ratio = 21:9, quality = medium, resolution = 4k1.86$0.0186
aspect_ratio = 9:21, quality = medium, resolution = 4k1.86$0.0186
aspect_ratio = 16:9, quality = medium, resolution = 2k1.91$0.0191
aspect_ratio = 9:16, quality = medium, resolution = 2k1.91$0.0191
aspect_ratio = 4:5, quality = low, resolution = 4k1.99$0.0199
aspect_ratio = 5:4, quality = low, resolution = 4k1.99$0.0199
aspect_ratio = 1:3, quality = high, resolution = 1k2.09$0.0209
aspect_ratio = 3:1, quality = high, resolution = 1k2.09$0.0209
aspect_ratio = 2:3, quality = medium, resolution = 2k2.13$0.0213
aspect_ratio = 3:2, quality = medium, resolution = 2k2.13$0.0213
aspect_ratio = 3:4, quality = medium, resolution = 2k2.39$0.0239
aspect_ratio = 4:3, quality = medium, resolution = 2k2.39$0.0239
aspect_ratio = 1:1, quality = low, resolution = 4k2.43$0.0243
aspect_ratio = 1:2, quality = medium, resolution = 4k2.49$0.0249
aspect_ratio = 2:1, quality = medium, resolution = 4k2.49$0.0249
aspect_ratio = 4:5, quality = medium, resolution = 2k2.59$0.0259
aspect_ratio = 5:4, quality = medium, resolution = 2k2.59$0.0259
aspect_ratio = 21:9, quality = high, resolution = 1k2.79$0.0279
aspect_ratio = 9:21, quality = high, resolution = 1k2.79$0.0279
aspect_ratio = 16:9, quality = high, resolution = 1k3.6$0.036
aspect_ratio = 9:16, quality = high, resolution = 1k3.6$0.036
aspect_ratio = 16:9, quality = medium, resolution = 4k3.17$0.0317
aspect_ratio = 9:16, quality = medium, resolution = 4k3.17$0.0317
aspect_ratio = 1:2, quality = high, resolution = 1k3.22$0.0322
aspect_ratio = 2:1, quality = high, resolution = 1k3.22$0.0322
aspect_ratio = 1:1, quality = medium, resolution = 2k3.27$0.0327
aspect_ratio = 2:3, quality = high, resolution = 1k4.2$0.042
aspect_ratio = 3:2, quality = high, resolution = 1k4.2$0.042
aspect_ratio = 3:4, quality = high, resolution = 1k4.72$0.0472
aspect_ratio = 4:3, quality = high, resolution = 1k4.72$0.0472
aspect_ratio = 2:3, quality = medium, resolution = 4k3.58$0.0358
aspect_ratio = 3:2, quality = medium, resolution = 4k3.58$0.0358
aspect_ratio = 1:3, quality = high, resolution = 2k3.62$0.0362
aspect_ratio = 3:1, quality = high, resolution = 2k3.62$0.0362
aspect_ratio = 1:3, quality = xhigh, resolution = 1k3.62$0.0362
aspect_ratio = 3:1, quality = xhigh, resolution = 1k3.62$0.0362
aspect_ratio = 1:1, quality = high, resolution = 1k6.38$0.0638
aspect_ratio = 3:4, quality = medium, resolution = 4k3.94$0.0394
aspect_ratio = 4:3, quality = medium, resolution = 4k3.94$0.0394
aspect_ratio = 4:5, quality = medium, resolution = 4k4.28$0.0428
aspect_ratio = 5:4, quality = medium, resolution = 4k4.28$0.0428
aspect_ratio = 21:9, quality = xhigh, resolution = 1k4.74$0.0474
aspect_ratio = 9:21, quality = xhigh, resolution = 1k4.74$0.0474
aspect_ratio = 1:3, quality = high, resolution = 4k4.84$0.0484
aspect_ratio = 3:1, quality = high, resolution = 4k4.84$0.0484
aspect_ratio = 4:5, quality = high, resolution = 1k5.18$0.0518
aspect_ratio = 5:4, quality = high, resolution = 1k5.18$0.0518
aspect_ratio = 1:1, quality = medium, resolution = 4k5.4$0.054
aspect_ratio = 21:9, quality = high, resolution = 2k5.53$0.0553
aspect_ratio = 9:21, quality = high, resolution = 2k5.53$0.0553
aspect_ratio = 1:2, quality = xhigh, resolution = 1k5.68$0.0568
aspect_ratio = 2:1, quality = xhigh, resolution = 1k5.68$0.0568
aspect_ratio = 1:3, quality = xhigh, resolution = 2k6.28$0.0628
aspect_ratio = 3:1, quality = xhigh, resolution = 2k6.28$0.0628
aspect_ratio = 1:2, quality = high, resolution = 2k6.46$0.0646
aspect_ratio = 2:1, quality = high, resolution = 2k6.46$0.0646
aspect_ratio = 16:9, quality = xhigh, resolution = 1k6.53$0.0653
aspect_ratio = 9:16, quality = xhigh, resolution = 1k6.53$0.0653
aspect_ratio = 16:9, quality = high, resolution = 2k7.21$0.0721
aspect_ratio = 9:16, quality = high, resolution = 2k7.21$0.0721
aspect_ratio = 2:3, quality = xhigh, resolution = 1k7.47$0.0747
aspect_ratio = 3:2, quality = xhigh, resolution = 1k7.47$0.0747
aspect_ratio = 21:9, quality = high, resolution = 4k7.62$0.0762
aspect_ratio = 9:21, quality = high, resolution = 4k7.62$0.0762
aspect_ratio = 1:3, quality = max, resolution = 1k8.19$0.0819
aspect_ratio = 3:1, quality = max, resolution = 1k8.19$0.0819
aspect_ratio = 2:3, quality = high, resolution = 2k8.31$0.0831
aspect_ratio = 3:2, quality = high, resolution = 2k8.31$0.0831
aspect_ratio = 3:4, quality = xhigh, resolution = 1k8.34$0.0834
aspect_ratio = 4:3, quality = xhigh, resolution = 1k8.34$0.0834
aspect_ratio = 1:3, quality = xhigh, resolution = 4k8.43$0.0843
aspect_ratio = 3:1, quality = xhigh, resolution = 4k8.43$0.0843
aspect_ratio = 4:5, quality = xhigh, resolution = 1k8.98$0.0898
aspect_ratio = 5:4, quality = xhigh, resolution = 1k8.98$0.0898
aspect_ratio = 3:4, quality = high, resolution = 2k9.36$0.0936
aspect_ratio = 4:3, quality = high, resolution = 2k9.36$0.0936
aspect_ratio = 21:9, quality = xhigh, resolution = 2k9.44$0.0944
aspect_ratio = 9:21, quality = xhigh, resolution = 2k9.44$0.0944
aspect_ratio = 1:2, quality = high, resolution = 4k9.78$0.0978
aspect_ratio = 2:1, quality = high, resolution = 4k9.78$0.0978
aspect_ratio = 4:5, quality = high, resolution = 2k10.2$0.102
aspect_ratio = 5:4, quality = high, resolution = 2k10.2$0.102
aspect_ratio = 21:9, quality = max, resolution = 1k10.72$0.1072
aspect_ratio = 9:21, quality = max, resolution = 1k10.72$0.1072
aspect_ratio = 1:1, quality = xhigh, resolution = 1k11.3$0.113
aspect_ratio = 1:2, quality = xhigh, resolution = 2k11.44$0.1144
aspect_ratio = 2:1, quality = xhigh, resolution = 2k11.44$0.1144
aspect_ratio = 16:9, quality = high, resolution = 4k12.07$0.1207
aspect_ratio = 9:16, quality = high, resolution = 4k12.07$0.1207
aspect_ratio = 1:2, quality = max, resolution = 1k12.44$0.1244
aspect_ratio = 2:1, quality = max, resolution = 1k12.44$0.1244
aspect_ratio = 1:1, quality = high, resolution = 2k12.9$0.129
aspect_ratio = 21:9, quality = xhigh, resolution = 4k13.01$0.1301
aspect_ratio = 9:21, quality = xhigh, resolution = 4k13.01$0.1301
aspect_ratio = 16:9, quality = xhigh, resolution = 2k13.12$0.1312
aspect_ratio = 9:16, quality = xhigh, resolution = 2k13.12$0.1312
aspect_ratio = 2:3, quality = high, resolution = 4k14.14$0.1414
aspect_ratio = 3:2, quality = high, resolution = 4k14.14$0.1414
aspect_ratio = 1:3, quality = max, resolution = 2k14.29$0.1429
aspect_ratio = 3:1, quality = max, resolution = 2k14.29$0.1429
aspect_ratio = 16:9, quality = max, resolution = 1k14.47$0.1447
aspect_ratio = 9:16, quality = max, resolution = 1k14.47$0.1447
aspect_ratio = 2:3, quality = xhigh, resolution = 2k14.85$0.1485
aspect_ratio = 3:2, quality = xhigh, resolution = 2k14.85$0.1485
aspect_ratio = 3:4, quality = high, resolution = 4k15.6$0.156
aspect_ratio = 4:3, quality = high, resolution = 4k15.6$0.156
aspect_ratio = 3:4, quality = xhigh, resolution = 2k16.6$0.166
aspect_ratio = 4:3, quality = xhigh, resolution = 2k16.6$0.166
aspect_ratio = 2:3, quality = max, resolution = 1k16.61$0.1661
aspect_ratio = 3:2, quality = max, resolution = 1k16.61$0.1661
aspect_ratio = 4:5, quality = high, resolution = 4k16.94$0.1694
aspect_ratio = 5:4, quality = high, resolution = 4k16.94$0.1694
aspect_ratio = 1:2, quality = xhigh, resolution = 4k17.34$0.1734
aspect_ratio = 2:1, quality = xhigh, resolution = 4k17.34$0.1734
aspect_ratio = 4:5, quality = xhigh, resolution = 2k18.2$0.182
aspect_ratio = 5:4, quality = xhigh, resolution = 2k18.2$0.182
aspect_ratio = 3:4, quality = max, resolution = 1k18.69$0.1869
aspect_ratio = 4:3, quality = max, resolution = 1k18.69$0.1869
aspect_ratio = 1:3, quality = max, resolution = 4k19.18$0.1918
aspect_ratio = 3:1, quality = max, resolution = 4k19.18$0.1918
aspect_ratio = 4:5, quality = max, resolution = 1k20.26$0.2026
aspect_ratio = 5:4, quality = max, resolution = 1k20.26$0.2026
aspect_ratio = 1:1, quality = high, resolution = 4k21.41$0.2141
aspect_ratio = 16:9, quality = xhigh, resolution = 4k21.41$0.2141
aspect_ratio = 9:16, quality = xhigh, resolution = 4k21.41$0.2141
aspect_ratio = 21:9, quality = max, resolution = 2k21.42$0.2142
aspect_ratio = 9:21, quality = max, resolution = 2k21.42$0.2142
aspect_ratio = 1:1, quality = xhigh, resolution = 2k22.89$0.2289
aspect_ratio = 2:3, quality = xhigh, resolution = 4k25.29$0.2529
aspect_ratio = 3:2, quality = xhigh, resolution = 4k25.29$0.2529
aspect_ratio = 1:1, quality = max, resolution = 1k25.35$0.2535
aspect_ratio = 1:2, quality = max, resolution = 2k25.65$0.2565
aspect_ratio = 2:1, quality = max, resolution = 2k25.65$0.2565
aspect_ratio = 3:4, quality = xhigh, resolution = 4k27.68$0.2768
aspect_ratio = 4:3, quality = xhigh, resolution = 4k27.68$0.2768
aspect_ratio = 16:9, quality = max, resolution = 2k29.18$0.2918
aspect_ratio = 9:16, quality = max, resolution = 2k29.18$0.2918
aspect_ratio = 21:9, quality = max, resolution = 4k29.57$0.2957
aspect_ratio = 9:21, quality = max, resolution = 4k29.57$0.2957
aspect_ratio = 4:5, quality = xhigh, resolution = 4k30.27$0.3027
aspect_ratio = 5:4, quality = xhigh, resolution = 4k30.27$0.3027
aspect_ratio = 2:3, quality = max, resolution = 2k33.07$0.3307
aspect_ratio = 3:2, quality = max, resolution = 2k33.07$0.3307
aspect_ratio = 3:4, quality = max, resolution = 2k37.27$0.3727
aspect_ratio = 4:3, quality = max, resolution = 2k37.27$0.3727
aspect_ratio = 1:1, quality = xhigh, resolution = 4k38.01$0.3801
aspect_ratio = 1:2, quality = max, resolution = 4k38.93$0.3893
aspect_ratio = 2:1, quality = max, resolution = 4k38.93$0.3893
aspect_ratio = 4:5, quality = max, resolution = 2k41.13$0.4113
aspect_ratio = 5:4, quality = max, resolution = 2k41.13$0.4113
aspect_ratio = 16:9, quality = max, resolution = 4k48.09$0.4809
aspect_ratio = 9:16, quality = max, resolution = 4k48.09$0.4809
aspect_ratio = 1:1, quality = max, resolution = 2k51.44$0.5144
aspect_ratio = 2:3, quality = max, resolution = 4k56.38$0.5638
aspect_ratio = 3:2, quality = max, resolution = 4k56.38$0.5638
aspect_ratio = 3:4, quality = max, resolution = 4k62.21$0.6221
aspect_ratio = 4:3, quality = max, resolution = 4k62.21$0.6221
aspect_ratio = 4:5, quality = max, resolution = 4k68.48$0.6848
aspect_ratio = 5:4, quality = max, resolution = 4k68.48$0.6848
aspect_ratio = 1:1, quality = max, resolution = 4k85.45$0.8545

Parameters

FieldTypeDefaultAllowedWhat it does
promptRequiredstring—up to 5,000 charactersSay what to change and what must stay the same.
image_urlsRequiredarray<string (uri)>—up to 16 itemsOne to 16 source images, in the order your prompt refers to them.
mask_urlOptionalstring (uri)——Optional PNG mask: transparent pixels mark the area to repaint in the first source image.
aspect_ratioOptionalstring1:11:1, 1:2, 1:3, 2:1, 2:3, 3:1, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 9:21, 16:9, … (+1)Output aspect ratio.
resolutionOptionalstring1k1k, 2k, 4kOutput size tier.
qualityOptionalstringhighlow, medium, high, xhigh, maxRendering quality. Higher tiers add detail, time and cost.
num_outputsOptionalinteger11 to 10How many images to return, each billed separately.
input_fidelityOptionalstringlowlow, highHow closely to keep the look of the source images.
backgroundOptionalstringautoauto, transparent, opaqueBackground treatment of the result.
output_formatOptionalstringpngpng, jpeg, webpFile format of the returned images.
output_qualityOptionalinteger—0 to 100Compression quality for JPEG and WebP, from 0 to 100.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_urls. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "openai/gpt-image-2.5-sunburst/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "num_outputs": 1,
    "quality": "high",
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Next steps

On this page