GPT Image 2 API reference

Call GPT Image 2 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 58 s
Model IDs: openai/gpt-image-2/text-to-image
openai/gpt-image-2/edit

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/text-to-image

Price

Option	Credits (per image)	US dollars
`aspect_ratio = 1:3, quality = low, resolution = 1k`	0.27	$0.0027
`aspect_ratio = 3:1, quality = low, resolution = 1k`	0.27	$0.0027
`aspect_ratio = 21:9, quality = low, resolution = 1k`	0.37	$0.0037
`aspect_ratio = 9:21, quality = low, resolution = 1k`	0.37	$0.0037
`aspect_ratio = 1:2, quality = low, resolution = 1k`	0.41	$0.0041
`aspect_ratio = 2:1, quality = low, resolution = 1k`	0.41	$0.0041
`aspect_ratio = 1:3, quality = low, resolution = 2k`	0.43	$0.0043
`aspect_ratio = 3:1, quality = low, resolution = 2k`	0.43	$0.0043
`aspect_ratio = 16:9, quality = low, resolution = 1k`	0.46	$0.0046
`aspect_ratio = 9:16, quality = low, resolution = 1k`	0.46	$0.0046
`aspect_ratio = 2:3, quality = low, resolution = 1k`	0.54	$0.0054
`aspect_ratio = 3:2, quality = low, resolution = 1k`	0.54	$0.0054
`aspect_ratio = 1:3, quality = low, resolution = 4k`	0.56	$0.0056
`aspect_ratio = 3:1, quality = low, resolution = 4k`	0.56	$0.0056
`aspect_ratio = 3:4, quality = low, resolution = 1k`	0.58	$0.0058
`aspect_ratio = 4:3, quality = low, resolution = 1k`	0.58	$0.0058
`aspect_ratio = 4:5, quality = low, resolution = 1k`	0.63	$0.0063
`aspect_ratio = 5:4, quality = low, resolution = 1k`	0.63	$0.0063
`aspect_ratio = 21:9, quality = low, resolution = 2k`	0.67	$0.0067
`aspect_ratio = 9:21, quality = low, resolution = 2k`	0.67	$0.0067
`aspect_ratio = 1:1, quality = low, resolution = 1k`	0.77	$0.0077
`aspect_ratio = 1:2, quality = low, resolution = 2k`	0.77	$0.0077
`aspect_ratio = 2:1, quality = low, resolution = 2k`	0.77	$0.0077
`aspect_ratio = 16:9, quality = low, resolution = 2k`	0.86	$0.0086
`aspect_ratio = 9:16, quality = low, resolution = 2k`	0.86	$0.0086
`aspect_ratio = 21:9, quality = low, resolution = 4k`	0.9	$0.009
`aspect_ratio = 9:21, quality = low, resolution = 4k`	0.9	$0.009
`aspect_ratio = 2:3, quality = low, resolution = 2k`	1.01	$0.0101
`aspect_ratio = 3:2, quality = low, resolution = 2k`	1.01	$0.0101
`aspect_ratio = 3:4, quality = low, resolution = 2k`	1.1	$0.011
`aspect_ratio = 4:3, quality = low, resolution = 2k`	1.1	$0.011
`aspect_ratio = 1:2, quality = low, resolution = 4k`	1.14	$0.0114
`aspect_ratio = 2:1, quality = low, resolution = 4k`	1.14	$0.0114
`aspect_ratio = 4:5, quality = low, resolution = 2k`	1.22	$0.0122
`aspect_ratio = 5:4, quality = low, resolution = 2k`	1.22	$0.0122
`aspect_ratio = 16:9, quality = low, resolution = 4k`	1.4	$0.014
`aspect_ratio = 9:16, quality = low, resolution = 4k`	1.4	$0.014
`aspect_ratio = 1:1, quality = low, resolution = 2k`	1.49	$0.0149
`aspect_ratio = 2:3, quality = low, resolution = 4k`	1.68	$0.0168
`aspect_ratio = 3:2, quality = low, resolution = 4k`	1.68	$0.0168
`aspect_ratio = 3:4, quality = low, resolution = 4k`	1.79	$0.0179
`aspect_ratio = 4:3, quality = low, resolution = 4k`	1.79	$0.0179
`aspect_ratio = 4:5, quality = low, resolution = 4k`	1.99	$0.0199
`aspect_ratio = 5:4, quality = low, resolution = 4k`	1.99	$0.0199
`aspect_ratio = 1:3, quality = medium, resolution = 1k`	2.09	$0.0209
`aspect_ratio = 3:1, quality = medium, resolution = 1k`	2.09	$0.0209
`aspect_ratio = 1:1, quality = low, resolution = 4k`	2.43	$0.0243
`aspect_ratio = 21:9, quality = medium, resolution = 1k`	2.79	$0.0279
`aspect_ratio = 9:21, quality = medium, resolution = 1k`	2.79	$0.0279
`aspect_ratio = 1:2, quality = medium, resolution = 1k`	3.22	$0.0322
`aspect_ratio = 2:1, quality = medium, resolution = 1k`	3.22	$0.0322
`aspect_ratio = 16:9, quality = medium, resolution = 1k`	3.6	$0.036
`aspect_ratio = 9:16, quality = medium, resolution = 1k`	3.6	$0.036
`aspect_ratio = 2:3, quality = medium, resolution = 1k`	4.2	$0.042
`aspect_ratio = 3:2, quality = medium, resolution = 1k`	4.2	$0.042
`aspect_ratio = 3:4, quality = medium, resolution = 1k`	4.72	$0.0472
`aspect_ratio = 4:3, quality = medium, resolution = 1k`	4.72	$0.0472
`aspect_ratio = 4:5, quality = medium, resolution = 1k`	5.18	$0.0518
`aspect_ratio = 5:4, quality = medium, resolution = 1k`	5.18	$0.0518
`aspect_ratio = 1:3, quality = medium, resolution = 2k`	3.62	$0.0362
`aspect_ratio = 3:1, quality = medium, resolution = 2k`	3.62	$0.0362
`aspect_ratio = 1:1, quality = medium, resolution = 1k`	6.38	$0.0638
`aspect_ratio = 1:3, quality = medium, resolution = 4k`	4.84	$0.0484
`aspect_ratio = 3:1, quality = medium, resolution = 4k`	4.84	$0.0484
`aspect_ratio = 21:9, quality = medium, resolution = 2k`	5.53	$0.0553
`aspect_ratio = 9:21, quality = medium, resolution = 2k`	5.53	$0.0553
`aspect_ratio = 1:2, quality = medium, resolution = 2k`	6.46	$0.0646
`aspect_ratio = 2:1, quality = medium, resolution = 2k`	6.46	$0.0646
`aspect_ratio = 16:9, quality = medium, resolution = 2k`	7.21	$0.0721
`aspect_ratio = 9:16, quality = medium, resolution = 2k`	7.21	$0.0721
`aspect_ratio = 21:9, quality = medium, resolution = 4k`	7.62	$0.0762
`aspect_ratio = 9:21, quality = medium, resolution = 4k`	7.62	$0.0762
`aspect_ratio = 1:3, quality = high, resolution = 1k`	8.19	$0.0819
`aspect_ratio = 3:1, quality = high, resolution = 1k`	8.19	$0.0819
`aspect_ratio = 2:3, quality = medium, resolution = 2k`	8.31	$0.0831
`aspect_ratio = 3:2, quality = medium, resolution = 2k`	8.31	$0.0831
`aspect_ratio = 3:4, quality = medium, resolution = 2k`	9.36	$0.0936
`aspect_ratio = 4:3, quality = medium, resolution = 2k`	9.36	$0.0936
`aspect_ratio = 1:2, quality = medium, resolution = 4k`	9.78	$0.0978
`aspect_ratio = 2:1, quality = medium, resolution = 4k`	9.78	$0.0978
`aspect_ratio = 4:5, quality = medium, resolution = 2k`	10.2	$0.102
`aspect_ratio = 5:4, quality = medium, resolution = 2k`	10.2	$0.102
`aspect_ratio = 21:9, quality = high, resolution = 1k`	10.72	$0.1072
`aspect_ratio = 9:21, quality = high, resolution = 1k`	10.72	$0.1072
`aspect_ratio = 16:9, quality = medium, resolution = 4k`	12.07	$0.1207
`aspect_ratio = 9:16, quality = medium, resolution = 4k`	12.07	$0.1207
`aspect_ratio = 1:2, quality = high, resolution = 1k`	12.44	$0.1244
`aspect_ratio = 2:1, quality = high, resolution = 1k`	12.44	$0.1244
`aspect_ratio = 1:1, quality = medium, resolution = 2k`	12.9	$0.129
`aspect_ratio = 2:3, quality = medium, resolution = 4k`	14.14	$0.1414
`aspect_ratio = 3:2, quality = medium, resolution = 4k`	14.14	$0.1414
`aspect_ratio = 1:3, quality = high, resolution = 2k`	14.29	$0.1429
`aspect_ratio = 3:1, quality = high, resolution = 2k`	14.29	$0.1429
`aspect_ratio = 16:9, quality = high, resolution = 1k`	14.47	$0.1447
`aspect_ratio = 9:16, quality = high, resolution = 1k`	14.47	$0.1447
`aspect_ratio = 3:4, quality = medium, resolution = 4k`	15.6	$0.156
`aspect_ratio = 4:3, quality = medium, resolution = 4k`	15.6	$0.156
`aspect_ratio = 2:3, quality = high, resolution = 1k`	16.61	$0.1661
`aspect_ratio = 3:2, quality = high, resolution = 1k`	16.61	$0.1661
`aspect_ratio = 4:5, quality = medium, resolution = 4k`	16.94	$0.1694
`aspect_ratio = 5:4, quality = medium, resolution = 4k`	16.94	$0.1694
`aspect_ratio = 3:4, quality = high, resolution = 1k`	18.69	$0.1869
`aspect_ratio = 4:3, quality = high, resolution = 1k`	18.69	$0.1869
`aspect_ratio = 1:3, quality = high, resolution = 4k`	19.18	$0.1918
`aspect_ratio = 3:1, quality = high, resolution = 4k`	19.18	$0.1918
`aspect_ratio = 4:5, quality = high, resolution = 1k`	20.26	$0.2026
`aspect_ratio = 5:4, quality = high, resolution = 1k`	20.26	$0.2026
`aspect_ratio = 1:1, quality = medium, resolution = 4k`	21.41	$0.2141
`aspect_ratio = 21:9, quality = high, resolution = 2k`	21.42	$0.2142
`aspect_ratio = 9:21, quality = high, resolution = 2k`	21.42	$0.2142
`aspect_ratio = 1:1, quality = high, resolution = 1k`	25.35	$0.2535
`aspect_ratio = 1:2, quality = high, resolution = 2k`	25.65	$0.2565
`aspect_ratio = 2:1, quality = high, resolution = 2k`	25.65	$0.2565
`aspect_ratio = 16:9, quality = high, resolution = 2k`	29.18	$0.2918
`aspect_ratio = 9:16, quality = high, resolution = 2k`	29.18	$0.2918
`aspect_ratio = 21:9, quality = high, resolution = 4k`	29.57	$0.2957
`aspect_ratio = 9:21, quality = high, resolution = 4k`	29.57	$0.2957
`aspect_ratio = 2:3, quality = high, resolution = 2k`	33.07	$0.3307
`aspect_ratio = 3:2, quality = high, resolution = 2k`	33.07	$0.3307
`aspect_ratio = 3:4, quality = high, resolution = 2k`	37.27	$0.3727
`aspect_ratio = 4:3, quality = high, resolution = 2k`	37.27	$0.3727
`aspect_ratio = 1:2, quality = high, resolution = 4k`	38.93	$0.3893
`aspect_ratio = 2:1, quality = high, resolution = 4k`	38.93	$0.3893
`aspect_ratio = 4:5, quality = high, resolution = 2k`	41.13	$0.4113
`aspect_ratio = 5:4, quality = high, resolution = 2k`	41.13	$0.4113
`aspect_ratio = 16:9, quality = high, resolution = 4k`	48.09	$0.4809
`aspect_ratio = 9:16, quality = high, resolution = 4k`	48.09	$0.4809
`aspect_ratio = 1:1, quality = high, resolution = 2k`	51.44	$0.5144
`aspect_ratio = 2:3, quality = high, resolution = 4k`	56.38	$0.5638
`aspect_ratio = 3:2, quality = high, resolution = 4k`	56.38	$0.5638
`aspect_ratio = 3:4, quality = high, resolution = 4k`	62.21	$0.6221
`aspect_ratio = 4:3, quality = high, resolution = 4k`	62.21	$0.6221
`aspect_ratio = 4:5, quality = high, resolution = 4k`	68.48	$0.6848
`aspect_ratio = 5:4, quality = high, resolution = 4k`	68.48	$0.6848
`aspect_ratio = 1:1, quality = high, resolution = 4k`	85.45	$0.8545

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Describe the image you want.
`aspect_ratio`Optional	`string`	`1:1`	1: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.
`resolution`Optional	`string`	`1k`	1k, 2k, 4k	Output size tier.
`quality`Optional	`string`	`medium`	low, medium, high	Rendering quality. Higher tiers add detail, time and cost.
`num_outputs`Optional	`integer`	`1`	1 to 10	How many images to return, each billed separately.
`output_format`Optional	`string`	`png`	png, jpeg, webp	File format of the returned images.
`output_quality`Optional	`integer`	—	0 to 100	Compression 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/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": "medium",
    "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/edit

Price

Option	Credits (per image)	US dollars
`aspect_ratio = 1:3, quality = low, resolution = 1k`	0.27	$0.0027
`aspect_ratio = 3:1, quality = low, resolution = 1k`	0.27	$0.0027
`aspect_ratio = 21:9, quality = low, resolution = 1k`	0.37	$0.0037
`aspect_ratio = 9:21, quality = low, resolution = 1k`	0.37	$0.0037
`aspect_ratio = 1:2, quality = low, resolution = 1k`	0.41	$0.0041
`aspect_ratio = 2:1, quality = low, resolution = 1k`	0.41	$0.0041
`aspect_ratio = 1:3, quality = low, resolution = 2k`	0.43	$0.0043
`aspect_ratio = 3:1, quality = low, resolution = 2k`	0.43	$0.0043
`aspect_ratio = 16:9, quality = low, resolution = 1k`	0.46	$0.0046
`aspect_ratio = 9:16, quality = low, resolution = 1k`	0.46	$0.0046
`aspect_ratio = 2:3, quality = low, resolution = 1k`	0.54	$0.0054
`aspect_ratio = 3:2, quality = low, resolution = 1k`	0.54	$0.0054
`aspect_ratio = 1:3, quality = low, resolution = 4k`	0.56	$0.0056
`aspect_ratio = 3:1, quality = low, resolution = 4k`	0.56	$0.0056
`aspect_ratio = 3:4, quality = low, resolution = 1k`	0.58	$0.0058
`aspect_ratio = 4:3, quality = low, resolution = 1k`	0.58	$0.0058
`aspect_ratio = 4:5, quality = low, resolution = 1k`	0.63	$0.0063
`aspect_ratio = 5:4, quality = low, resolution = 1k`	0.63	$0.0063
`aspect_ratio = 21:9, quality = low, resolution = 2k`	0.67	$0.0067
`aspect_ratio = 9:21, quality = low, resolution = 2k`	0.67	$0.0067
`aspect_ratio = 1:1, quality = low, resolution = 1k`	0.77	$0.0077
`aspect_ratio = 1:2, quality = low, resolution = 2k`	0.77	$0.0077
`aspect_ratio = 2:1, quality = low, resolution = 2k`	0.77	$0.0077
`aspect_ratio = 16:9, quality = low, resolution = 2k`	0.86	$0.0086
`aspect_ratio = 9:16, quality = low, resolution = 2k`	0.86	$0.0086
`aspect_ratio = auto, quality = low, resolution = 1k`	0.88	$0.0088
`aspect_ratio = 21:9, quality = low, resolution = 4k`	0.9	$0.009
`aspect_ratio = 9:21, quality = low, resolution = 4k`	0.9	$0.009
`aspect_ratio = 2:3, quality = low, resolution = 2k`	1.01	$0.0101
`aspect_ratio = 3:2, quality = low, resolution = 2k`	1.01	$0.0101
`aspect_ratio = 3:4, quality = low, resolution = 2k`	1.1	$0.011
`aspect_ratio = 4:3, quality = low, resolution = 2k`	1.1	$0.011
`aspect_ratio = 1:2, quality = low, resolution = 4k`	1.14	$0.0114
`aspect_ratio = 2:1, quality = low, resolution = 4k`	1.14	$0.0114
`aspect_ratio = 4:5, quality = low, resolution = 2k`	1.22	$0.0122
`aspect_ratio = 5:4, quality = low, resolution = 2k`	1.22	$0.0122
`aspect_ratio = 16:9, quality = low, resolution = 4k`	1.4	$0.014
`aspect_ratio = 9:16, quality = low, resolution = 4k`	1.4	$0.014
`aspect_ratio = 1:1, quality = low, resolution = 2k`	1.49	$0.0149
`aspect_ratio = auto, quality = low, resolution = 2k`	1.49	$0.0149
`aspect_ratio = 2:3, quality = low, resolution = 4k`	1.68	$0.0168
`aspect_ratio = 3:2, quality = low, resolution = 4k`	1.68	$0.0168
`aspect_ratio = 3:4, quality = low, resolution = 4k`	1.79	$0.0179
`aspect_ratio = 4:3, quality = low, resolution = 4k`	1.79	$0.0179
`aspect_ratio = 4:5, quality = low, resolution = 4k`	1.99	$0.0199
`aspect_ratio = 5:4, quality = low, resolution = 4k`	1.99	$0.0199
`aspect_ratio = 1:3, quality = medium, resolution = 1k`	2.09	$0.0209
`aspect_ratio = 3:1, quality = medium, resolution = 1k`	2.09	$0.0209
`aspect_ratio = 1:1, quality = low, resolution = 4k`	2.43	$0.0243
`aspect_ratio = auto, quality = low, resolution = 4k`	2.43	$0.0243
`aspect_ratio = 21:9, quality = medium, resolution = 1k`	2.79	$0.0279
`aspect_ratio = 9:21, quality = medium, resolution = 1k`	2.79	$0.0279
`aspect_ratio = 1:2, quality = medium, resolution = 1k`	3.22	$0.0322
`aspect_ratio = 2:1, quality = medium, resolution = 1k`	3.22	$0.0322
`aspect_ratio = 16:9, quality = medium, resolution = 1k`	3.6	$0.036
`aspect_ratio = 9:16, quality = medium, resolution = 1k`	3.6	$0.036
`aspect_ratio = 2:3, quality = medium, resolution = 1k`	4.2	$0.042
`aspect_ratio = 3:2, quality = medium, resolution = 1k`	4.2	$0.042
`aspect_ratio = 3:4, quality = medium, resolution = 1k`	4.72	$0.0472
`aspect_ratio = 4:3, quality = medium, resolution = 1k`	4.72	$0.0472
`aspect_ratio = 4:5, quality = medium, resolution = 1k`	5.18	$0.0518
`aspect_ratio = 5:4, quality = medium, resolution = 1k`	5.18	$0.0518
`aspect_ratio = 1:3, quality = medium, resolution = 2k`	3.62	$0.0362
`aspect_ratio = 3:1, quality = medium, resolution = 2k`	3.62	$0.0362
`aspect_ratio = 1:1, quality = medium, resolution = 1k`	6.38	$0.0638
`aspect_ratio = auto, quality = medium, resolution = 1k`	7.47	$0.0747
`aspect_ratio = 1:3, quality = medium, resolution = 4k`	4.84	$0.0484
`aspect_ratio = 3:1, quality = medium, resolution = 4k`	4.84	$0.0484
`aspect_ratio = 21:9, quality = medium, resolution = 2k`	5.53	$0.0553
`aspect_ratio = 9:21, quality = medium, resolution = 2k`	5.53	$0.0553
`aspect_ratio = 1:2, quality = medium, resolution = 2k`	6.46	$0.0646
`aspect_ratio = 2:1, quality = medium, resolution = 2k`	6.46	$0.0646
`aspect_ratio = 16:9, quality = medium, resolution = 2k`	7.21	$0.0721
`aspect_ratio = 9:16, quality = medium, resolution = 2k`	7.21	$0.0721
`aspect_ratio = 21:9, quality = medium, resolution = 4k`	7.62	$0.0762
`aspect_ratio = 9:21, quality = medium, resolution = 4k`	7.62	$0.0762
`aspect_ratio = 1:3, quality = high, resolution = 1k`	8.19	$0.0819
`aspect_ratio = 3:1, quality = high, resolution = 1k`	8.19	$0.0819
`aspect_ratio = 2:3, quality = medium, resolution = 2k`	8.31	$0.0831
`aspect_ratio = 3:2, quality = medium, resolution = 2k`	8.31	$0.0831
`aspect_ratio = 3:4, quality = medium, resolution = 2k`	9.36	$0.0936
`aspect_ratio = 4:3, quality = medium, resolution = 2k`	9.36	$0.0936
`aspect_ratio = 1:2, quality = medium, resolution = 4k`	9.78	$0.0978
`aspect_ratio = 2:1, quality = medium, resolution = 4k`	9.78	$0.0978
`aspect_ratio = 4:5, quality = medium, resolution = 2k`	10.2	$0.102
`aspect_ratio = 5:4, quality = medium, resolution = 2k`	10.2	$0.102
`aspect_ratio = 21:9, quality = high, resolution = 1k`	10.72	$0.1072
`aspect_ratio = 9:21, quality = high, resolution = 1k`	10.72	$0.1072
`aspect_ratio = 16:9, quality = medium, resolution = 4k`	12.07	$0.1207
`aspect_ratio = 9:16, quality = medium, resolution = 4k`	12.07	$0.1207
`aspect_ratio = 1:2, quality = high, resolution = 1k`	12.44	$0.1244
`aspect_ratio = 2:1, quality = high, resolution = 1k`	12.44	$0.1244
`aspect_ratio = 1:1, quality = medium, resolution = 2k`	12.9	$0.129
`aspect_ratio = auto, quality = medium, resolution = 2k`	12.9	$0.129
`aspect_ratio = 2:3, quality = medium, resolution = 4k`	14.14	$0.1414
`aspect_ratio = 3:2, quality = medium, resolution = 4k`	14.14	$0.1414
`aspect_ratio = 1:3, quality = high, resolution = 2k`	14.29	$0.1429
`aspect_ratio = 3:1, quality = high, resolution = 2k`	14.29	$0.1429
`aspect_ratio = 16:9, quality = high, resolution = 1k`	14.47	$0.1447
`aspect_ratio = 9:16, quality = high, resolution = 1k`	14.47	$0.1447
`aspect_ratio = 3:4, quality = medium, resolution = 4k`	15.6	$0.156
`aspect_ratio = 4:3, quality = medium, resolution = 4k`	15.6	$0.156
`aspect_ratio = 2:3, quality = high, resolution = 1k`	16.61	$0.1661
`aspect_ratio = 3:2, quality = high, resolution = 1k`	16.61	$0.1661
`aspect_ratio = 4:5, quality = medium, resolution = 4k`	16.94	$0.1694
`aspect_ratio = 5:4, quality = medium, resolution = 4k`	16.94	$0.1694
`aspect_ratio = 3:4, quality = high, resolution = 1k`	18.69	$0.1869
`aspect_ratio = 4:3, quality = high, resolution = 1k`	18.69	$0.1869
`aspect_ratio = 1:3, quality = high, resolution = 4k`	19.18	$0.1918
`aspect_ratio = 3:1, quality = high, resolution = 4k`	19.18	$0.1918
`aspect_ratio = 4:5, quality = high, resolution = 1k`	20.26	$0.2026
`aspect_ratio = 5:4, quality = high, resolution = 1k`	20.26	$0.2026
`aspect_ratio = 1:1, quality = medium, resolution = 4k`	21.41	$0.2141
`aspect_ratio = auto, quality = medium, resolution = 4k`	21.41	$0.2141
`aspect_ratio = 21:9, quality = high, resolution = 2k`	21.42	$0.2142
`aspect_ratio = 9:21, quality = high, resolution = 2k`	21.42	$0.2142
`aspect_ratio = 1:1, quality = high, resolution = 1k`	25.35	$0.2535
`aspect_ratio = 1:2, quality = high, resolution = 2k`	25.65	$0.2565
`aspect_ratio = 2:1, quality = high, resolution = 2k`	25.65	$0.2565
`aspect_ratio = 16:9, quality = high, resolution = 2k`	29.18	$0.2918
`aspect_ratio = 9:16, quality = high, resolution = 2k`	29.18	$0.2918
`aspect_ratio = 21:9, quality = high, resolution = 4k`	29.57	$0.2957
`aspect_ratio = 9:21, quality = high, resolution = 4k`	29.57	$0.2957
`aspect_ratio = auto, quality = high, resolution = 1k`	29.7	$0.297
`aspect_ratio = 2:3, quality = high, resolution = 2k`	33.07	$0.3307
`aspect_ratio = 3:2, quality = high, resolution = 2k`	33.07	$0.3307
`aspect_ratio = 3:4, quality = high, resolution = 2k`	37.27	$0.3727
`aspect_ratio = 4:3, quality = high, resolution = 2k`	37.27	$0.3727
`aspect_ratio = 1:2, quality = high, resolution = 4k`	38.93	$0.3893
`aspect_ratio = 2:1, quality = high, resolution = 4k`	38.93	$0.3893
`aspect_ratio = 4:5, quality = high, resolution = 2k`	41.13	$0.4113
`aspect_ratio = 5:4, quality = high, resolution = 2k`	41.13	$0.4113
`aspect_ratio = 16:9, quality = high, resolution = 4k`	48.09	$0.4809
`aspect_ratio = 9:16, quality = high, resolution = 4k`	48.09	$0.4809
`aspect_ratio = 1:1, quality = high, resolution = 2k`	51.44	$0.5144
`aspect_ratio = auto, quality = high, resolution = 2k`	51.44	$0.5144
`aspect_ratio = 2:3, quality = high, resolution = 4k`	56.38	$0.5638
`aspect_ratio = 3:2, quality = high, resolution = 4k`	56.38	$0.5638
`aspect_ratio = 3:4, quality = high, resolution = 4k`	62.21	$0.6221
`aspect_ratio = 4:3, quality = high, resolution = 4k`	62.21	$0.6221
`aspect_ratio = 4:5, quality = high, resolution = 4k`	68.48	$0.6848
`aspect_ratio = 5:4, quality = high, resolution = 4k`	68.48	$0.6848
`aspect_ratio = 1:1, quality = high, resolution = 4k`	85.45	$0.8545
`aspect_ratio = auto, quality = high, resolution = 4k`	85.45	$0.8545

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Say what to change and what must stay the same.
`image_urls`Required	`array<string (uri)>`	—	up to 10 items	One to 10 source images, in the order your prompt refers to them.
`mask_url`Optional	`string (uri)`	—	—	Optional PNG mask: transparent pixels mark the area to repaint in the first source image.
`aspect_ratio`Optional	`string`	`auto`	auto, 1: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, … (+2)	Output aspect ratio; auto keeps the shape of the first source image.
`resolution`Optional	`string`	`1k`	1k, 2k, 4k	Output size tier.
`quality`Optional	`string`	`medium`	low, medium, high	Rendering quality. Higher tiers add detail, time and cost.
`num_outputs`Optional	`integer`	`1`	1 to 10	How many images to return, each billed separately.
`input_fidelity`Optional	`string`	`low`	low, high	How closely to keep the look of the source images.
`background`Optional	`string`	`auto`	auto, opaque	Background treatment of the result.
`output_format`Optional	`string`	`png`	png, jpeg, webp	File format of the returned images.
`output_quality`Optional	`integer`	—	0 to 100	Compression 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/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": "medium",
    "resolution": "1k",
    "aspect_ratio": "auto"
  }
}'

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"

GPT Image 2 API reference

At a glance

Create Image

Price

Parameters

Example request

Edit Image

Price

Parameters

Example request

Next steps

On this page