Introduction
La retouche Sunburst accepte 1–16 sources et une consigne textuelle précisant les éléments à conserver ou à remplacer. Un masque PNG aux mêmes dimensions peut délimiter la zone à repeindre dans la première image.
| Champ | Valeur |
|---|---|
| Entrée | Image |
| Sortie | Image |
| Éditeur | OpenAI |
| Date de sortie | 2026-11-05 |
| Modèle API | gpt-image-2.6-sunburst |
| Points de terminaison publics | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Qualité | low, medium (par défaut), high, xhigh, max |
| Résolution | 1k : environ 1 MP ; 2k : environ 3,7 MP ; 4k : environ 8,3 MP |
| Dimensions en 16:9 | 2k : 2560 x 1440 ; 4k : 3840 x 2160 |
| Rapports d’aspect | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Nombre de sorties | 1–10 images par demande |
| Sources de retouche | 1–16 images sources |
| Masque | PNG facultatif, aux dimensions de la première image ; les pixels transparents indiquent la zone à repeindre |
| Fond | auto, opaque, transparent ; la transparence exige PNG ou WebP |
| Formats de fichier | PNG (par défaut), JPEG, WebP · GIF (génération depuis un texte uniquement) |
Fonctionnalités et points forts
Demi-tour sur le balcon
Un demi-tour défini et un éclairage nocturne fournissent des détails précis pour examiner la continuité.
Toast au bar de jazz
Le toast suivi du clin d’œil donne une progression claire à la boucle.
Retouche de manteau à Paris
La retouche Sunburst précise le sujet à conserver avant de demander un manteau et un décor pluvieux.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Consigne de retouche Sunburst obligatoire de 5 000 caractères maximum, sans texte par défaut ; les tokens du prompt sont facturés, donc les consignes Sunburst plus longues coûte… 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | Fournissez 1–16 URL d’images sources Sunburst, sans source par défaut ; désignez-les par Image 1, Image 2, etc., et prévoyez un petit montant pour chaque image source. 1 éléments minimum · 16 éléments maximum |
mask_url | Non | Le masque PNG facultatif de Sunburst reprend les dimensions de la première image ; ses pixels transparents désignent la zone à repeindre, sans frais propres au masque. |
markup_url | Non | Transmettez à Sunburst avec |
aspect_ratio | Non | Choisissez l’un des 15 formats Sunburst, de 1:3 à 3:1. |
resolution | Non | Choisissez une taille Sunburst : 1k (environ 1 MP), 2k (environ 3,7 MP) ou 4k (environ 8,3 MP) ; aucune valeur par défaut n’est précisée ici et ce niveau modifie le prix. |
quality | Non | Réglez le détail Sunburst sur low, medium (par défaut), high, xhigh ou max ; les niveaux supérieurs augmentent le détail, le temps de rendu et le prix. |
reasoning_effort | Non | Sunburst utilise |
num_outputs | Non | Demandez 1–10 images par requête Sunburst ; aucun nombre par défaut n’est précisé ici et chaque image produite est facturée. |
background | Non | Les fonds Sunburst peuvent être auto, opaque ou transparent, sans valeur par défaut précisée ici ; utilisez PNG ou WebP pour la transparence, sans supplément lié au fond. |
output_format | Non | Sunburst encode les fichiers en png par défaut, avec jpeg et webp comme alternatives ; le choix du format ne modifie pas le prix. |
output_quality | Non | Pour une image modifiée par Sunburst enregistrée en JPEG ou WebP, la compression va de 0 à 100 ; le PNG n’en tient pas compte et le prix reste identique. |
Tarification
Sunburst facture les retouches selon les tokens réellement utilisés par chaque demande : le texte du prompt, les tokens d’image de chaque image fournie et ceux du résultat. Le prix affiché pour un niveau de qualité et de résolution correspond à un résultat Sunburst carré, hors images sources ; les autres rapports coûtent donc généralement moins cher. Sunburst compte à nouveau les tokens du prompt et des entrées pour chaque résultat demandé. Sunburst réserve le montant maximal au lancement d’une tâche et restitue la part inutilisée une fois celle-ci terminée. Les demandes Sunburst refusées ne sont pas facturées.
| Résolution | Qualité: low | Qualité: medium | Qualité: high | Qualité: xhigh | Qualité: max |
|---|---|---|---|---|---|
| $0.02232 / image | $0.03915 / image | $0.04743 / image | $0.08433 / image | $0.18972 / image |
| $0.04131 / image | $0.07299 / image | $0.08847 / image | $0.15723 / image | $0.35379 / image |
| $0.07479 / image | $0.13221 / image | $0.16011 / image | $0.28512 / image | $0.64044 / image |
Cas d’utilisation
Visuels de campagne touristique
Créez une affiche de bord de mer avec une destination nommée, un titre court et une palette maîtrisée.
Visuels de menu de café
Décrivez la disposition d’une ardoise avec les entrées du menu entre guillemets et une ambiance matinale bien définie.
Retouches de portrait
Transposez un portrait fourni dans une rue sous la pluie en demandant de préserver la continuité avec la source.
Guide de prompt et conseils pratiques
Définissez le brief visuel
Décrivez le sujet, les matières et la lumière, puis placez entre guillemets les courts textes à afficher.
Choisissez le détail et les dimensions
Commencez en qualité medium et choisissez 1k, 2k ou 4k selon l’emplacement prévu pour l’image.
Précisez la retouche
Pour une retouche, placez la source en premier et décrivez ce qu’il faut conserver avant d’indiquer le remplacement.
Délimitez une zone
Fournissez un masque PNG aux dimensions de la première image si le changement concerne une zone précise.
Introduction
GPT Image 2.6 Sunburst Retouche d’image modifie une image fournie à partir d’une consigne écrite. Ce niveau axé sur la précision privilégie la fidélité et la stabilité des détails au fil des modifications, avec 1–16 images sources possibles.
Placez l’image à retoucher en premier et expliquez le rôle de chaque référence supplémentaire. Un masque PNG facultatif délimite une zone à repeindre ; lors de nos tests, un changement de tenue et de lieu a préservé l’apparence de la personne.
Fonctionnalités et points forts
- Retouches annotées : envoyez à Sunburst via
markup_urlun PNG transparent aux dimensions de la première image, avec cercles, croquis ou notes. Sunburst n’ajoute aucuns frais d’entrée distincts pour ce calque et exclutmask_url. - Références numérotées : appelez les sources Image 1, Image 2, etc. pour expliquer ce que chacune apporte.
- Retouche locale : les pixels transparents d’un masque PNG aux mêmes dimensions désignent la zone à modifier dans la première source.
- Conservation de la forme : omettre
aspect_ratioconserve la forme de la première image en 1k ; le 2k et le 4k exigent un rapport sélectionné. - Réglages de détail : cinq niveaux de qualité permettent d’obtenir davantage de détails moyennant plus de temps de rendu et un coût supérieur.
- Formats de livraison : enregistrez vos retouches en PNG, JPEG ou WebP, avec la transparence disponible en PNG et WebP.
Cas d’usage
- Changement de tenue : transformez un portrait fourni en une scène avec trench camel pour un concept de campagne.
- Changement de lieu : transposez un sujet existant dans une rue parisienne pluvieuse en précisant ce qui doit rester.
- Correction graphique localisée : délimitez une zone d’affiche avec un masque et demandez un autre détail de fond.
Guide du prompt et conseils
- Nommez la source : commencez par « Image 1 est le portrait à retoucher » pour identifier la base de la consigne.
- Décrivez la continuité : ajoutez « conservez l’apparence de la personne » avant de décrire une nouvelle tenue ou un nouveau décor.
- Attribuez les rôles aux références : écrivez « utilisez la palette de couleurs de Image 2 » lorsque vous ajoutez une source.
- Décrivez le remplacement masqué : essayez « remplacez le mur marqué par une peinture bleu canard » avec un masque PNG adapté.
- Précisez le nouveau décor : « rue parisienne sous la pluie à l’heure bleue » définit à la fois le lieu et l’éclairage.
- Ajustez
reasoning_effortsur low, medium ou high (par défaut). Plus de planification aide les textes denses et les mises en page complexes, avec un délai accru mais un tarif inchangé.
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.6-sunburst/edit",
"input": {
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# 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.
