Introduction
GPT Image 2 Retouche d’image applique le modèle gpt-image-2 d’OpenAI à des images que vous avez déjà. Donnez-lui une à dix images sources et une consigne : changer un vêtement ou une couleur, réécrire un titre, rééclairer une scène ou réunir des personnes et des lieux de plusieurs sources dans une seule image. Un masque PNG facultatif limite la retouche à une seule zone.
Choisir le mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | GPT Image 2 Texte vers image |
| une image à modifier | GPT Image 2 Retouche d’image |
Fonctionnalités et points forts
Retouche par consigne, masquée si besoin
Sans masque, le modèle déduit du prompt ce qu’il faut changer et redessine le reste en cohérence. Avec un masque, seuls les pixels transparents sont repeints et tout le reste est conservé.
Jusqu’à dix sources par requête
Désignez chaque source par son ordre : la première image apporte la personne, la deuxième le décor, la troisième le produit. Le modèle les réunit dans une nouvelle image.
Maîtrise de la fidélité et du format
Input_fidelity high garde les visages, les tissus et les détails imprimés plus proches des sources. Le format auto conserve la forme de la première source ; l’un des quinze formats fixes donne cette forme au résultat.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Mettez entre guillemets chaque mot qui doit apparaître dans l’image et indiquez où il se place ; le reste est lu comme de la description. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De 1 à 10 images sources. Désignez-les dans le prompt par leur ordre (la première image, la deuxième image). 1 éléments minimum · 10 éléments maximum |
mask_url | Non | PNG facultatif de la même taille que la première image source. Les pixels transparents marquent la zone à repeindre ; les pixels opaques sont conservés. |
aspect_ratio | Non | auto (par défaut) garde le format de la première image source à environ 1,5 mégapixel et ignore le niveau de taille ; sinon, choisissez l’un des quinze formats de 1:3 à 3:1. |
resolution | Non | 1k (par défaut), 2k ou 4k. Une image carrée fait 1024, 2048 ou 2880 pixels de côté ; un niveau supérieur coûte plus cher par image. |
quality | Non | low, medium (par défaut) ou high. OpenAI facture au token de sortie : à taille égale, chaque niveau coûte environ quatre à neuf fois le précédent. |
num_outputs | Non | De 1 à 10 images par requête, 1 par défaut. Chaque image est facturée séparément. |
input_fidelity | Non | low (par défaut) ou high. High conserve plus fidèlement les visages, les tissus et les détails imprimés des sources. |
background | Non | auto (par défaut) ou opaque. OpenAI ne propose pas de sortie transparente pour GPT Image 2 ; pour les détourages, utilisez GPT Image 2.5 Sunburst ou Flare. |
output_format | Non | png (par défaut), jpeg ou webp. Ne change pas le prix. |
output_quality | Non | Qualité de compression pour jpeg et webp, de 0 à 100 : une valeur élevée garde plus de détail et produit des fichiers plus lourds. Inutilisée en png, sans effet sur le prix. |
official_fallback | Non | Activé par défaut. Valeur par défaut: |
Tarification
Facturé par image produite selon la qualité, le niveau de taille et le format ; sur la voie officielle, chaque image source ajoute en plus un montant fixe pour chaque image produite. Le devis affiche le total avant l’envoi. Une requête pour une seule retouche PNG en qualité medium et taille 1k, dans n’importe quel format sauf 21:9, 9:21, 3:1 et 1:3, sans masque, avec input fidelity low et background auto part sur la voie économique, au prix économique. Avec Official fallback (activé par défaut), une requête que cette voie refuse ou ne peut pas mener à bien repart sur la voie officielle au prix officiel : le devis affiche donc le prix de départ et le montant maximal. Les requêtes refusées ne sont pas facturées. Sur la voie officielle, un prompt long ajoute un petit montant pour les tokens d’entrée au-delà des 100 premiers, une fois par requête ; un texte en chinois, japonais ou coréen compte environ un token par caractère.
| Spécification | Prix |
|---|---|
| $0.001816 / image |
| $0.001816 / image |
| $0.00244 / image |
| $0.00244 / image |
| $0.002752 / image |
| $0.002752 / image |
| $0.002872 / image |
| $0.002872 / image |
| $0.00304 / image |
| $0.00304 / image |
| $0.003568 / image |
| $0.003568 / image |
| $0.003736 / image |
| $0.003736 / image |
| $0.003856 / image |
| $0.003856 / image |
| $0.004192 / image |
| $0.004192 / image |
| $0.004456 / image |
| $0.004456 / image |
| $0.005104 / image |
| $0.005152 / image |
| $0.005152 / image |
| $0.005704 / image |
| $0.005704 / image |
| $0.005896 / image |
| $0.006016 / image |
| $0.006016 / image |
| $0.006712 / image |
| $0.006712 / image |
| $0.007312 / image |
| $0.007312 / image |
| $0.0076 / image |
| $0.0076 / image |
| $0.008128 / image |
| $0.008128 / image |
| $0.009304 / image |
| $0.009304 / image |
| $0.009928 / image |
| $0.009928 / image |
| $0.011176 / image |
| $0.011176 / image |
| $0.01192 / image |
| $0.01192 / image |
| $0.01324 / image |
| $0.01324 / image |
| $0.016216 / image |
| $0.016216 / image |
| $0.01396 / image |
| $0.01396 / image |
| $0.018592 / image |
| $0.018592 / image |
| $0.020368 / image (Avec Official fallback : jusqu’à $0.021472) |
| $0.020368 / image (Avec Official fallback : jusqu’à $0.021472) |
| $0.020998 / image (Avec Official fallback : jusqu’à $0.023992) |
| $0.020998 / image (Avec Official fallback : jusqu’à $0.023992) |
| $0.022 / image (Avec Official fallback : jusqu’à $0.028) |
| $0.022 / image (Avec Official fallback : jusqu’à $0.028) |
| $0.022864 / image (Avec Official fallback : jusqu’à $0.031456) |
| $0.022864 / image (Avec Official fallback : jusqu’à $0.031456) |
| $0.023626 / image (Avec Official fallback : jusqu’à $0.034504) |
| $0.023626 / image (Avec Official fallback : jusqu’à $0.034504) |
| $0.024112 / image |
| $0.024112 / image |
| $0.025636 / image (Avec Official fallback : jusqu’à $0.042544) |
| $0.027448 / image (Avec Official fallback : jusqu’à $0.049792) |
| $0.032272 / image |
| $0.032272 / image |
| $0.03688 / image |
| $0.03688 / image |
| $0.043072 / image |
| $0.043072 / image |
| $0.048064 / image |
| $0.048064 / image |
| $0.050776 / image |
| $0.050776 / image |
| $0.055432 / image |
| $0.055432 / image |
| $0.062416 / image |
| $0.062416 / image |
| $0.0652 / image |
| $0.0652 / image |
| $0.067984 / image |
| $0.067984 / image |
| $0.080464 / image |
| $0.080464 / image |
| $0.086032 / image |
| $0.086032 / image |
| $0.094288 / image |
| $0.094288 / image |
| $0.103984 / image |
| $0.103984 / image |
| $0.11296 / image |
| $0.11296 / image |
| $0.14272 / image |
| $0.14272 / image |
| $0.054616 / image |
| $0.054616 / image |
| $0.07144 / image |
| $0.07144 / image |
| $0.082936 / image |
| $0.082936 / image |
| $0.095248 / image |
| $0.095248 / image |
| $0.096472 / image |
| $0.096472 / image |
| $0.110728 / image |
| $0.110728 / image |
| $0.124624 / image |
| $0.124624 / image |
| $0.127864 / image |
| $0.127864 / image |
| $0.135064 / image |
| $0.135064 / image |
| $0.142816 / image |
| $0.142816 / image |
| $0.168976 / image |
| $0.171016 / image |
| $0.171016 / image |
| $0.19456 / image |
| $0.19456 / image |
| $0.197104 / image |
| $0.197104 / image |
| $0.197968 / image |
| $0.220456 / image |
| $0.220456 / image |
| $0.248464 / image |
| $0.248464 / image |
| $0.259552 / image |
| $0.259552 / image |
| $0.274216 / image |
| $0.274216 / image |
| $0.320608 / image |
| $0.320608 / image |
| $0.342928 / image |
| $0.342928 / image |
| $0.37588 / image |
| $0.37588 / image |
| $0.414736 / image |
| $0.414736 / image |
| $0.456544 / image |
| $0.456544 / image |
| $0.569656 / image |
| $0.569656 / image |
Cas d’utilisation
Réécrire et restyler des visuels finis
Remplacez les mots d’une affiche ou d’une couverture, la couleur d’un produit ou un vêtement, et gardez la photo exactement telle qu’elle a été validée.
Composer des scènes à partir de références
Placez une personne d’une photo dans le décor d’une autre, ou réunissez deux personnes de prises séparées, sans reconstruire la mise en page à partir d’un prompt texte.
Versions localisées d’un même visuel
Gardez la photo et remplacez le titre par une ligne traduite pour chaque marché, une retouche par langue.
Guide de prompt et conseils pratiques
Dire ce qui reste et ce qui change
Énoncez d’abord le changement, puis ce qui ne doit pas bouger : visage, pose, lumière, fond, logo. Tout ce que vous ne protégez pas peut être redessiné.
Numéroter vos sources
Écrivez « la femme de la première image » et « le bateau de la deuxième image ». L’ordre dans image_urls est le seul moyen pour le modèle de les distinguer.
Utiliser un masque pour les petites corrections
Pour un seul objet ou un morceau de fond, un masque PNG de la taille de la première source est plus fiable qu’une description en mots.
Garder auto pour un cadrage fidèle
Laissez le format sur auto quand la retouche doit garder le cadrage de la source ; choisissez un format fixe seulement si le résultat a besoin d’une nouvelle forme.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2/edit",
"input": {
"aspect_ratio": "auto",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.





