PopNowDocs API
Contenu principal

Référence API de GPT Image 2.5 Flare

Le modèle d’OpenAI axé vitesse, avec retouches par masque et détourages

Une seule clé API PopNow suffit pour appeler GPT Image 2.5 Flare depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur
OpenAI
Résultat
Image
À partir de
0.27 crédits par image ($0.0027)
Durée habituelle
environ 82 s

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une image

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

Prix

OptionCrédits (par image)Dollars US
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

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresDescribe the image you want.
aspect_ratioFacultatifstring1: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.
resolutionFacultatifstring1k1k, 2k, 4kOutput size tier.
qualityFacultatifstringhighlow, medium, high, xhigh, maxRendering quality. Higher tiers add detail, time and cost.
num_outputsFacultatifinteger1de 1 à 10How many images to return, each billed separately.
output_formatFacultatifstringpngpng, jpeg, webpFile format of the returned images.
output_qualityFacultatifinteger—de 0 à 100Compression quality for JPEG and WebP, from 0 to 100.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

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-flare/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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Modifier une image

openai/gpt-image-2.5-flare/edit

Prix

OptionCrédits (par image)Dollars US
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

Paramètres

ChampTypeValeur par défautValeurs admisesRôle
promptObligatoirestring—jusqu’à 5 000 caractèresSay what to change and what must stay the same.
image_urlsObligatoirearray<string (uri)>—jusqu’à 16 élémentsOne to 16 source images, in the order your prompt refers to them.
mask_urlFacultatifstring (uri)——Optional PNG mask: transparent pixels mark the area to repaint in the first source image.
aspect_ratioFacultatifstring1: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.
resolutionFacultatifstring1k1k, 2k, 4kOutput size tier.
qualityFacultatifstringhighlow, medium, high, xhigh, maxRendering quality. Higher tiers add detail, time and cost.
num_outputsFacultatifinteger1de 1 à 10How many images to return, each billed separately.
input_fidelityFacultatifstringlowlow, highHow closely to keep the look of the source images.
backgroundFacultatifstringautoauto, transparent, opaqueBackground treatment of the result.
output_formatFacultatifstringpngpng, jpeg, webpFile format of the returned images.
output_qualityFacultatifinteger—de 0 à 100Compression quality for JPEG and WebP, from 0 to 100.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

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-flare/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"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

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"

Pour aller plus loin

Sur cette page