Introduction
GPT Image 2.5 Sunburst Retouche d’image applique le gpt-image-2.5-sunburst d’OpenAI à des images que vous avez déjà. Il accepte une à seize sources, un masque PNG facultatif et l’option de fond transparent, et c’est le modèle qu’OpenAI recommande quand la précision de retouche compte le plus.
Choisir le mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | GPT Image 2.5 Sunburst Texte vers image |
| une image à modifier | GPT Image 2.5 Sunburst Retouche d’image |
Fonctionnalités et points forts
Masques, fidélité et transparence
Un masque limite la retouche à ses pixels transparents ; input_fidelity high garde les visages et les tissus plus proches des sources ; background transparent renvoie un vrai canal alpha en PNG ou WebP.
Jusqu’à seize sources
Réunissez personnes, décors et produits de jusqu’à seize images en une requête, chacune désignée par son ordre dans le prompt. Chaque source ajoute un montant fixe d’entrée à chaque image produite : n’incluez que les références utiles.
La précision est le but
Dans notre retouche de la robe cramoisie, seul le tissu a changé : les manches en dentelle, le visage, la chaise et l’unique lumière principale sont restés à leur place.
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
Retoucher des photos validées
Changez un vêtement, une couleur ou la lumière d’une photo validée sans toucher au reste de l’image, avec ou sans masque.
Détourages pour la mise en page
Personnes et produits renvoyés sur fond transparent, prêts pour une mise en page, une diapositive ou une fiche produit sans étape de détourage séparée.
Déclinaisons de couleur de produit
Une même photo produit en plusieurs finitions ou couleurs, masquée sur le produit pour que le décor et la lumière restent identiques.
Guide de prompt et conseils pratiques
Construire le masque à la taille de la source
Même taille en pixels que la première source, enregistré en PNG, transparent seulement là où il faut repeindre. Tout ce qui est opaque est protégé.
Écrire la liste des éléments protégés
Après le changement, nommez ce qui doit rester : visage, cheveux, pose, chaise, lumière. Le modèle suit une liste écrite plus fidèlement qu’une liste implicite.
Pour un détourage, dire ce qui reste
Nommez le sujet à garder et précisez que le fond doit être entièrement transparent, puis réglez output_format sur png ou webp.
Vérifier l’alpha avant la mise en page
Ouvrez le PNG ou WebP renvoyé dans votre outil de mise en page : la zone vide est un vrai canal alpha, aucune étape supplémentaire d’incrustation ou de masquage n’est nécessaire.
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-sunburst/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.





