Introduction
GPT Image 2.5 Flare Retouche d’image applique le gpt-image-2.5-flare d’OpenAI à des images que vous avez déjà. Il accepte une à seize sources, un masque PNG et l’option de fond transparent, et renvoie les retouches assez vite pour un usage interactif.
Choisir le mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | GPT Image 2.5 Flare Texte vers image |
| une image à modifier | GPT Image 2.5 Flare Retouche d’image |
Fonctionnalités et points forts
Compositions rapides à plusieurs sources
Deux sources ou plus deviennent une scène, avec les visages conservés depuis leurs propres images. Notre exemple à deux sources a pris nettement moins d’une minute.
Masques et détourages
Un masque PNG limite la retouche à une zone ; background transparent renvoie un vrai canal alpha en PNG ou WebP, prêt pour une mise en page sans étape d’incrustation.
Plusieurs changements en une passe
La tenue, le moment de la journée et la météo peuvent changer ensemble, pourvu que le prompt dise aussi ce qui doit rester identique. Notre exemple de terrasse a changé la robe et la lumière en une requête.
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 à 16 images sources. Désignez-les dans le prompt par leur ordre (la première image, la deuxième image). 1 éléments minimum · 16 é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 | Quinze formats de 1:3 à 3:1, 1:1 par défaut. Le résultat prend le format choisi, pas celui de la source, et le format change le prix. |
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, high (par défaut), xhigh ou max. Chaque niveau ajoute du détail, du temps et du coût ; réservez xhigh et max aux versions finales. |
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), transparent ou opaque. Transparent exige une sortie png ou webp et renvoie un vrai canal alpha. |
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é high et taille 1k, au format 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 ou 9:16, 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.00304 / image |
| $0.00304 / image |
| $0.003568 / image |
| $0.003568 / image |
| $0.003808 / image |
| $0.003808 / image |
| $0.003856 / image |
| $0.003856 / image |
| $0.004192 / image |
| $0.004192 / image |
| $0.004744 / image |
| $0.004744 / image |
| $0.005104 / image |
| $0.00568 / image |
| $0.00568 / image |
| $0.00652 / image |
| $0.00652 / image |
| $0.007312 / image |
| $0.007312 / image |
| $0.008176 / image |
| $0.008176 / image |
| $0.008728 / image |
| $0.008728 / image |
| $0.010936 / image |
| $0.01396 / image |
| $0.01396 / image |
| $0.018592 / image |
| $0.018592 / image |
| $0.020998 / image (Avec Official fallback : jusqu’à $0.023992) |
| $0.020998 / image (Avec Official fallback : jusqu’à $0.023992) |
| $0.021472 / image |
| $0.021472 / image |
| $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.024136 / image |
| $0.024136 / image |
| $0.025636 / image (Avec Official fallback : jusqu’à $0.042544) |
| $0.0316 / image |
| $0.0316 / image |
| $0.034504 / image |
| $0.034504 / image |
| $0.037864 / image |
| $0.037864 / image |
| $0.043504 / image |
| $0.043504 / image |
| $0.049816 / image |
| $0.049816 / image |
| $0.054616 / image |
| $0.054616 / image |
| $0.055624 / image |
| $0.055624 / image |
| $0.059872 / image |
| $0.059872 / image |
| $0.07144 / image |
| $0.07144 / image |
| $0.075328 / image |
| $0.082936 / image |
| $0.082936 / image |
| $0.096472 / image |
| $0.096472 / image |
| $0.110728 / image |
| $0.110728 / image |
| $0.124624 / image |
| $0.124624 / image |
| $0.135064 / image |
| $0.135064 / image |
| $0.168976 / image |
| $0.002872 / image |
| $0.002872 / image |
| $0.004456 / image |
| $0.004456 / image |
| $0.005152 / image |
| $0.005152 / image |
| $0.005704 / image |
| $0.005704 / image |
| $0.006328 / image |
| $0.006328 / image |
| $0.006712 / image |
| $0.006712 / image |
| $0.007312 / image |
| $0.007312 / image |
| $0.008128 / image |
| $0.008128 / image |
| $0.009088 / image |
| $0.009088 / image |
| $0.009928 / image |
| $0.01108 / image |
| $0.01108 / image |
| $0.01276 / image |
| $0.01276 / image |
| $0.014176 / image |
| $0.014176 / image |
| $0.015904 / image |
| $0.015904 / image |
| $0.017296 / image |
| $0.017296 / image |
| $0.021808 / image |
| $0.024112 / image |
| $0.024112 / image |
| $0.03688 / image |
| $0.03688 / image |
| $0.041896 / image |
| $0.041896 / image |
| $0.043072 / image |
| $0.043072 / image |
| $0.048064 / image |
| $0.048064 / image |
| $0.055432 / image |
| $0.055432 / image |
| $0.062416 / image |
| $0.062416 / image |
| $0.062944 / image |
| $0.062944 / image |
| $0.067984 / image |
| $0.067984 / image |
| $0.07624 / image |
| $0.07624 / image |
| $0.086032 / image |
| $0.087496 / image |
| $0.087496 / image |
| $0.095248 / image |
| $0.095248 / image |
| $0.098968 / image |
| $0.098968 / image |
| $0.110656 / image |
| $0.110656 / image |
| $0.121312 / image |
| $0.121312 / image |
| $0.142816 / image |
| $0.142816 / image |
| $0.152632 / image |
| $0.171016 / image |
| $0.171016 / image |
| $0.19456 / image |
| $0.19456 / image |
| $0.220456 / image |
| $0.220456 / image |
| $0.248464 / image |
| $0.248464 / image |
| $0.274216 / image |
| $0.274216 / image |
| $0.342928 / image |
| $0.003736 / image |
| $0.003736 / image |
| $0.006016 / image |
| $0.006016 / image |
| $0.0076 / image |
| $0.0076 / image |
| $0.008368 / image |
| $0.008368 / image |
| $0.009304 / image |
| $0.009304 / image |
| $0.011176 / image |
| $0.011176 / image |
| $0.01192 / image |
| $0.01192 / image |
| $0.0124 / image |
| $0.0124 / image |
| $0.01324 / image |
| $0.01324 / image |
| $0.016216 / image |
| $0.0166 / image |
| $0.0166 / image |
| $0.02116 / image |
| $0.02116 / image |
| $0.023872 / image |
| $0.023872 / image |
| $0.026296 / image |
| $0.026296 / image |
| $0.028552 / image |
| $0.028552 / image |
| $0.032272 / image |
| $0.032272 / image |
| $0.035992 / image |
| $0.050776 / image |
| $0.050776 / image |
| $0.056176 / image |
| $0.056176 / image |
| $0.0652 / image |
| $0.0652 / image |
| $0.080464 / image |
| $0.080464 / image |
| $0.086752 / image |
| $0.086752 / image |
| $0.094288 / image |
| $0.094288 / image |
| $0.103984 / image |
| $0.103984 / image |
| $0.11296 / image |
| $0.11296 / image |
| $0.115576 / image |
| $0.115576 / image |
| $0.127864 / image |
| $0.127864 / image |
| $0.14272 / image |
| $0.14272 / image |
| $0.14272 / image |
| $0.168592 / image |
| $0.168592 / image |
| $0.184552 / image |
| $0.184552 / image |
| $0.197104 / image |
| $0.197104 / image |
| $0.201832 / image |
| $0.201832 / image |
| $0.253408 / image |
| $0.259552 / image |
| $0.259552 / image |
| $0.320608 / image |
| $0.320608 / image |
| $0.37588 / image |
| $0.37588 / image |
| $0.414736 / image |
| $0.414736 / image |
| $0.456544 / image |
| $0.456544 / image |
| $0.569656 / image |
Cas d’utilisation
Essayages et restylages
Montrez la même personne dans une nouvelle tenue ou un nouveau lieu pour un lookbook ou une maquette de campagne, avec plusieurs options par requête.
Réunir des personnes de prises séparées
Placez dans une même image deux personnes photographiées séparément, pour une affiche, une miniature ou un panneau de story.
Renouvellements saisonniers
Transformez une image de campagne d’été en version d’automne ou de nuit pour la saison suivante, la personne et le produit restant les mêmes.
Guide de prompt et conseils pratiques
Donner un rôle à chaque source
L’homme et le seuil de la première image, la femme de la deuxième : écrivez-le, car l’ordre est le seul lien entre le prompt et les sources.
Regrouper les changements liés
Une nouvelle robe et un autre moment de la journée se formulent bien en une requête ; des changements sans lien valent mieux en retouches séparées.
Monter la fidélité pour les visages
Réglez input_fidelity sur high quand un visage doit rester reconnaissable après la retouche ; le prix ne change pas.
Masquer pour changer le fond
Quand seul le fond doit changer, gardez le sujet opaque et le fond transparent dans un masque PNG de la taille de la première source.
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.5-flare/edit",
"input": {
"aspect_ratio": "1:1",
"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.





