Construire avec CometAPIBesoin d'une seule API pour plusieurs modèles ?Testez le workflow dans Playground, puis créez une clé API lorsque le modèle et le coût correspondent à votre cas d'usage.
Comment utiliser l’API GPT Image 2.6 : génération de SVG et édition d’images
Apprenez les flux de travail de l'API GPT Image 2.6 avec CometAPI : génération de SVG, PNG transparents, édition multi-images, balisage, paramètres, tarification et migration.
Deon GoodwinÉquipe de recherche sur les modèles IA et API
L’API GPT Image 2.6 dans CometAPI offre aux développeurs une voie pratique pour générer et éditer des images avec deux variantes : Sunburst et Flare.
Créez des assets image avec Python et une clé CometAPI : commencez par une requête raster, puis ajoutez une sortie SVG, des images de référence, ou une couche d’annotation PNG transparente lorsque votre route les prend en charge. Les exemples utilisent Python 3.10 ou ultérieur et conservent la clé API sur votre serveur.
La distinction la plus importante : un PNG transparent en sortie est un asset final ; un fichier PNG transparent de marquage est un input qui indique au modèle où éditer.
Points clés
Utilisez GPT Image 2.6 Flare pour des brouillons rapides et Sunburst pour des révisions détaillées.
Envoyez les requêtes de génération et les requêtes d’édition vers leurs endpoints Image API respectifs.
Revu pour la clarté, l'attribution des sources et la terminologie API actuelle.
Utilisez le SVG pour les assets vectoriels et le PNG transparent pour les détourages raster.
Gardez le marquage séparé de l’image source et faites correspondre leurs dimensions orientées.
Confirmez la prise en charge de la route avant d’activer des champs avancés dans votre application.
Qu’est-ce que l’API GPT Image 2.6 ?
OpenAI a lancé GPT Image 2.6 le 4 novembre 2026. La famille de modèles accepte des entrées texte et image pour la création et la révision visuelles.
Les deux variantes ont un rôle orienté workflow, mais leurs priorités diffèrent.
Spécification
Sunburst
Flare
Identifiant API
gpt-image-2.6-sunburst
gpt-image-2.6-flare
Focalisation principale
Travail visuel détaillé
Itération rapide
Modalités d’entrée
Texte et images
Texte et images
Modalité de sortie
Images
Images
Point de départ pratique
Assets finaux et révisions soignées
Brouillons et édition interactive
Prise en charge audio
Non
Non
Quels paramètres l’API GPT Image 2.6 prend-elle en charge ?
Commencez avec une configuration réduite et explicite.
Paramètre
Requête de génération
Usage pratique
model
Identifiant de variante explicite
Garder la sélection du modèle reproductible
prompt
Instructions textuelles
Décrire l’asset et ses contraintes
quality
Commencer par low, medium ou high
Ajuster la qualité de rendu
complexity
low, medium ou high
Ajuster l’effort de planification
size
Par exemple, 1024x1024
Fixer les dimensions pour comparer
n
Utiliser 1 au départ
Simplifier les tests et la revue des coûts
output_format
PNG, JPEG, WebP, SVG ou GIF, selon l’endpoint
Faire correspondre l’asset aval
background
auto, opaque ou transparent
Contrôler le comportement du fond raster
Pour les éditions, la requête fournit aussi des images sources. Le schéma image-edit prend en charge jusqu’à 16 images de référence.
Laissez complexity à sa valeur par défaut pour une première génération. Pour une édition ciblée (p. ex. recolorer un objet), commencez par low et vérifiez que les détails environnants restent intacts.
Comment utiliser l’API GPT Image 2.6 avec CometAPI ?
Suivez le guide de configuration CometAPI pour créer une clé, puis stockez-la dans la variable d’environnement ci-dessous. Vous aurez aussi besoin de fichiers PNG locaux pour les exemples d’édition.
Les exemples utilisent Python requests pour montrer directement les corps JSON et multipart.
Ces exemples emploient le format de requête de l’Image API d’OpenAI via CometAPI. Avant de les exécuter, confirmez que votre route CometAPI sélectionnée prend en charge le modèle et les champs utilisés dans l’exemple.
Installer les dépendances
pip install requests pillow
Définissez la clé dans votre shell :
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
Sous PowerShell, utilisez :
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"
Créer des helpers de requêtes partagés
Enregistrez les helpers partagés sous image_workflows.py. Placez chaque workflow d’exemple dans un script séparé et importez les helpers nécessaires. N’exécutez que le workflow que vous souhaitez tester.
Ce helper lève une erreur pour une réponse HTTP non réussie ou des données base64 invalides. Il s’attend à data[0].b64_json ; si votre route renvoie une structure différente, inspectez cette réponse avant de modifier la fonction d’enregistrement.
Conservez l’enregistrement d’usage renvoyé avec la sortie. Si une requête dépasse le délai, inspectez son statut ou l’enregistrement de facturation avant de la soumettre à nouveau : un timeout n’établit pas que la génération a échoué.
Générer une première image
Exécutez cet appel après les helpers partagés pour générer une image produit unique et l’enregistrer sous cup.png.
Pour les exemples d’édition ultérieurs, faites une copie de cup.png nommée product.png dans le même répertoire de travail. Gardez cup.png inchangé comme original. Vous pouvez aussi utiliser votre propre photo produit, enregistrée sous product.png.
Préparez setting.png séparément : utilisez une photographie PNG du fond ou du décor où vous souhaitez placer la tasse, avec suffisamment d’espace dégagé pour le produit. Utilisez une image que vous êtes autorisé à téléverser. Enregistrez-la à côté de product.png ; la requête multi-références l’utilise pour le décor, et non comme seconde référence produit.
generate(
prompt=(
"Create a studio product photograph of an unbranded teal "
"ceramic travel cup on a warm cream background. "
"Show one cup, a clean silhouette, and a soft contact shadow. "
"No text or decorative objects."
),
destination="cup.png",
output_format="png",
)
Vérifiez le résultat à l’aide d’une courte checklist d’acceptation : une seule tasse, bonne couleur, silhouette propre, pas d’objets supplémentaires.
Comment générer du SVG avec GPT Image 2.6 ?
Utilisez la sortie SVG pour des assets vectoriels éditables. Demandez-la via l’endpoint de génération avec n=1, puis décodez la réponse dans un fichier .svg. La sortie SVG ne prend pas en charge le streaming.
generate(
prompt=(
"Design an original minimalist icon of a teal travel cup "
"with a small leaf motif. Use simple closed vector shapes, "
"two flat colors, and generous negative space. "
"No text, gradients, photographs, or background scenery."
),
destination="cup-icon.svg",
output_format="svg",
)
Un test d’acceptation SVG utile va au-delà de l’ouverture du fichier :
Inspectez l’icône en petite et grande tailles.
Vérifiez si les formes et couleurs sont faciles à éditer.
Confirmez que le résultat s’intègre au système visuel prévu.
Inspectez le XML avant d’intégrer un SVG fourni par un tiers dans une application.
N’envoyez pas un SVG comme entrée pour une édition raster. Séparez les workflows de révision vectorielle et d’édition d’image.
Comment créer des assets PNG transparents avec GPT Image 2.6 ?
Pour un détourage, demandez une sortie PNG et un fond transparent. L’exemple transparent-logo officiel insiste aussi sur des bords alpha nets et l’absence de damier « peint ».
generate(
prompt=(
"Create a single teal ceramic travel cup as an isolated "
"e-commerce asset. Center the entire cup with generous padding. "
"Keep clean edges and a fully transparent background. "
"No floor, backdrop, checkerboard pattern, or text."
),
destination="cup-transparent.png",
output_format="png",
background="transparent",
)
Validez la transparence effective :
from PIL import Image
with Image.open("cup-transparent.png") as image:
alpha = image.convert("RGBA").getchannel("A")
minimum, maximum = alpha.getextrema()
if minimum == 255:
raise RuntimeError("The output contains no transparent pixels.")
if maximum == 0:
raise RuntimeError("The output is entirely transparent.")
print("The output contains visible content and transparency.")
Cela détecte une image opaque déguisée en détourage. Cela n’évalue pas la qualité des bords ; inspectez l’asset sur fond clair et sombre.
Comment éditer des images avec plusieurs références GPT Image 2.6 ?
Attribuez à chaque référence un rôle spécifique. Dans cet exemple, la première image fournit l’identité produit et la seconde le décor souhaité.
with (
open("product.png", "rb") as product,
open("setting.png", "rb") as setting,
):
response = requests.post(
f"{BASE_URL}/images/edits",
headers=HEADERS,
data={
"model": "gpt-image-2.6-sunburst",
"prompt": (
"Use the cup in the first image as the exact product "
"reference. Use the second image only for the setting. "
"Place the cup naturally in that setting. Preserve its "
"silhouette, lid, color, and printed details. "
"Do not copy other products from the second image."
),
"quality": "high",
"complexity": "medium",
"output_format": "png",
},
files=[
("image[]", ("product.png", product, "image/png")),
("image[]", ("setting.png", setting, "image/png")),
],
timeout=(15, 300),
)
save_result(response, "product-in-setting.png")
L’exemple multipart utilise image[]. Les requêtes d’édition JSON utilisent un tableau images ; ne mélangez pas les deux encodages.
Pour des tests reproductibles, gardez l’ordre des références fixe. Comparez le produit original au résultat en pleine résolution, en particulier les anses, étiquettes, bords et reflets.
Comment fonctionne le PNG transparent de marquage dans GPT Image 2.6 ?
Le marquage est une couche d’annotation. Dessinez un cercle ou une autre instruction visuelle sur un PNG transparent séparé, puis envoyez ce fichier avec l’image originale.
Le workflow de marquage applique les annotations à la première image d’entrée. La superposition doit correspondre à ses dimensions orientées, contenir des pixels transparents et rester séparée de l’originale. N’associez pas markup avec mask ou prompt_rewriter.
La démonstration d’OpenAI montre un vase marqué :
L’édition résultante modifie le vase :
Ce sont des images de démonstration officielles, pas des sorties du code ci-dessous.
Préparer une couche d’annotation
La boîte englobante ci-dessous définit l’ellipse d’annotation. Ajustez ses coordonnées pour entourer l’objet à éditer, puis inspectez la superposition avant de soumettre.
with (
open("product-oriented.png", "rb") as source,
open("markup.png", "rb") as markup,
):
response = requests.post(
f"{BASE_URL}/images/edits",
headers=HEADERS,
data={
"model": MODEL,
"prompt": (
"Change the body of the cup inside the red circle "
"to matte cobalt blue. Preserve the lid, shape, "
"lighting, and surrounding scene. "
"Remove the annotation from the finished image."
),
"quality": "medium",
"complexity": "low",
"output_format": "png",
},
files={
"image": ("product.png", source, "image/png"),
"markup": ("markup.png", markup, "image/png"),
},
timeout=(15, 300),
)
save_result(response, "cup-edited.png")
Le choix de conception important est de spécifier à la fois le changement demandé et ce qu’il faut préserver. Une annotation identifie la cible ; le texte définit l’opération.
Tarification de l’API GPT Image 2.6 : taux de tokens et coûts SVG
Les deux variantes partagent les taux de tokens OpenAI suivants.
Catégorie de tokens
Tarif Sunburst pour 1 M de tokens
Tarif Flare pour 1 M de tokens
Text input
$5.00
$5.00
Cached text input
$1.25
$1.25
Image input
$8.00
$8.00
Cached image input
$2.00
$2.00
Image output
$30.00
$30.00
Ce sont des tarifs OpenAI, pas un devis CometAPI vérifié.
Pour une requête non mise en cache, le calcul correspondant est :
Par exemple, une requête raster utilisant 1 000 tokens d’entrée texte, aucun token d’entrée image, et 2 000 tokens de sortie image coûterait $0.065.
Pour GPT Image 2.6 API dans CometAPI, utilisez le prix affiché pour votre route et vérifiez la charge enregistrée pour votre requête. Les tarifs OpenAI ci-dessus sont un calcul de référence, pas un devis CometAPI.
Un indicateur métier utile est :
Cost per accepted asset =
total workflow spending ÷ number of approved assets
Incluez dans le numérateur les générations rejetées et les tours de révision.
Comment migrer un workflow d’image existant vers GPT Image 2.6 ?
Si vous utilisez déjà GPT Image 2.5, mettez d’abord à jour l’identifiant du modèle et gardez l’endpoint et la gestion de réponse explicites. Ajoutez les formats de sortie optionnels seulement après la réussite d’une requête de base.
Définissez model="gpt-image-2.6-flare" ou model="gpt-image-2.6-sunburst" plutôt que de compter sur un modèle par défaut. Conservez vos fichiers d’entrée et votre prompt existants tout en vérifiant la première réponse.
Pour le SVG, utilisez l’endpoint de génération, enregistrez les octets décodés avec une extension .svg, et omettez le streaming. Pour les éditions raster, conservez les images sources dans la requête d’édition. Ajoutez markup seulement après avoir préparé une superposition transparente séparée.
Mettez aussi à jour votre couche de diffusion de fichiers : un asset SVG et un asset PNG exigent des types MIME différents. Conservez la source originale et les révisions approuvées. Commencez chaque nouvelle édition à partir de la version qui contient les changements que vous souhaitez préserver.
Conclusion
Commencez par l’exemple d’image produit, puis choisissez le workflow adapté à votre sortie : SVG pour les illustrations vectorielles éditables, PNG transparent pour les détourages, références d’images pour combiner des entrées visuelles, ou marquage pour des changements ciblés. Comparez Flare et Sunburst avec les mêmes prompts et réglages, et suivez le coût par asset accepté.
FAQ
Comment gérer un timeout de requête GPT Image 2.6 ?
Un timeout peut survenir alors que le serveur traite encore la requête. Enregistrez l’ID de la requête et vérifiez le journal du fournisseur avant de réessayer afin d’éviter les doublons de travail et de facturation.
Pourquoi mon application échoue-t-elle à enregistrer l’image renvoyée ?
Le helper s’attend à une réponse JSON contenant data[0].b64_json. Vérifiez d’abord le statut HTTP et la structure de la réponse. Si votre route renvoie une URL d’image, implémentez le flux documenté de téléchargement par URL plutôt que de passer cette URL à un décodeur base64. Gardez l’extension enregistrée cohérente avec le format demandé.
Comment éviter d’écraser les fichiers d’édition ?
Enregistrez séparément la source, la superposition et chaque sortie. Par exemple, utilisez product-source.png, product-markup.png et product-edit-01.png. Stockez le prompt à côté de la sortie. Cela vous permet de revenir sur une révision sans perdre l’original ni téléverser par erreur un aperçu annoté comme source.
Que vérifier avant d’intégrer un SVG généré ?
Ouvrez l’asset dans votre moteur cible et inspectez son XML avec vos outils de validation SVG habituels. Vérifiez dimensions, clipping, chemins et tout texte avant publication. Appliquez la politique de sécurisation SVG de votre application, servez-le avec le type MIME correct et assurez-vous qu’il reste lisible à la plus petite taille utilisée dans votre interface.