API d'Édition d'Images et de Référence GPT Image 2.5 Sunburst sur E2X
GPT Image 2.5 Sunburst edit-image est le point de terminaison d'édition conditionnée par référence d'OpenAI sur E2X, disponible sur openai/gpt-image-2.5-sunburst/edit-image. Passez une ou plusieurs URL sources dans image_urls accompagnées d'une instruction pouvant atteindre 50 000 caractères, et le modèle modifie le visuel existant, assemble plusieurs produits dans une seule scène ou remplace un lettrage intégré. Avec notre remise permanente de 75 %, une édition en 1K est facturée $0.0525 par image générée, que vous choisissiez la qualité low, medium, high, xhigh ou max, soit un tarif inférieur de 75 % à la référence de palier supérieur de $0.211 sur fal.ai.
Vous générez uniquement à partir d'une description écrite sans aucune photo de référence ? Appelez plutôt GPT Image 2.5 Sunburst text-to-image, qui applique la même grille tarifaire et ne requiert que prompt. GPT Image 2.5 Sunburst prend en charge les 5 paliers de qualité (low, medium, high, xhigh, max) en 1K, 2K et 4K, tandis que GPT Image 2.5 Flare (edit-image) répond aux flux de travail standards à 3 paliers (low, medium, high).
Tarification par édition selon les paliers de résolution et de qualité
Chaque requête d'édition sur openai/gpt-image-2.5-sunburst/edit-image débute par un tarif de base catalogue de $0.03 (30,000 micro-centimes) que notre remise globale de 75 % ramène à $0.0075 (7,500 micro-centimes) avant d'appliquer deux coefficients de paramètres :
- Facteur
resolution : 1K (par défaut) = ×1, 2K = ×2, 4K = ×3.
- Facteur
quality : low, medium, high (par défaut), xhigh et max portent chacun un coefficient ×7.
Comme les cinq options de quality multiplient toutes la base remisée de $0.0075 par 7 ($0.0075 × 7 = $0.0525 en 1K), resolution est l'unique levier de coût. Vous pouvez exécuter une qualité high, xhigh ou max exactement au même prix que low. De plus, contrairement à notre ancienne route GPT Image 2 edit-image où quality était un champ obligatoire, quality sur GPT Image 2.5 Sunburst est facultatif et réglé par défaut sur high.
Matrice tarifaire complète par édition vérifiée le 4 novembre 2026 :
| Résolution de sortie | Tarif E2X remisé | Tarif catalogue avant remise | Facteur combiné | Équivalent fal.ai | Étape d'édition typique |
|---|
1K (défaut du schéma) | $0.0525 | $0.21 | 1 × 7 | $0.211 (75 % plus cher) | Ajustement de prompt, tests de texte d'étiquette, changements d'arrière-plan |
2K | $0.1050 | $0.42 | 2 × 7 | $0.222 (53 % plus cher) | Packshots e-commerce de production et bannières web principales |
4K | $0.1575 | $0.63 | 3 × 7 | $0.401 (61 % plus cher) | Compositions prêtes pour l'impression et exports maîtres haute résolution |
Cette structure tarifaire simplifie la budgétisation d'une boucle d'édition. Lorsque vous ajustez un prompt pour remplacer le texte sur l'étiquette d'une bouteille ou que vous testez trois ambiances lumineuses différentes pour un produit détouré, maintenez resolution à 1K ($0.0525 l'unité) tout en exécutant une qualité high ou xhigh. Cinq éditions exploratoires en 1K plus un export final en 2K ($0.105) reviennent à $0.3675 au total.
Les prix et les conditions des produits peuvent évoluer. Vérifiez les tarifs actuels de chaque fournisseur avant de prendre une décision d'achat. La tarification Google Batch ou Flex n'est pas directement équivalente à une requête API standard à la demande car la planification, la disponibilité et les conditions de traitement diffèrent ; elle est donc exclue de cette comparaison. Il s'agit d'une comparaison ciblée, et non d'une affirmation selon laquelle E2X est l'option la moins chère au monde dans toutes les configurations.
Principaux flux de travail d'édition pour ce point de terminaison
- Localisation et remplacement de texte intégré à l'image : Fournissez au point de terminaison une affiche terminée, un patron d'emballage ou une carte d'interface et indiquez la chaîne de remplacement exacte entre guillemets. Le modèle met à jour les mots tout en conservant la mise en page environnante, la perspective et l'ombrage de surface intacts.
- Composition de scène multi-références : Passez un tableau d'URL sources dans
image_urls pour combiner des éléments distincts dans un seul cadre, par exemple en plaçant un produit détouré de l'image 1 sur la table de studio montrée dans l'image 2 sous la palette de couleurs de l'image 3.
- Changements d'attributs ciblés et restylage : Conservez la géométrie du sujet fixe tout en modifiant les matériaux, la tenue vestimentaire, l'heure de la journée ou le décor d'arrière-plan via un prompt différentiel.
- Budget de prompt étendu à 50 000 caractères : Tandis que son homologue texte-vers-image plafonne les prompts à 32 000 caractères,
edit-image accepte jusqu'à 50 000 caractères, offrant aux pipelines automatisés tout l'espace nécessaire pour transmettre des spécifications de mise en page détaillées, des chartes graphiques et des instructions par référence.
Requête API : soumission d'URL sources et interrogation
prompt et image_urls sont les deux paramètres obligatoires sur openai/gpt-image-2.5-sunburst/edit-image. aspect_ratio (1:1 par défaut), resolution (1K par défaut) et quality (high par défaut) sont facultatifs.
Voici un appel curl qui soumet une modification d'étiquette d'emballage en qualité xhigh et résolution 2K ($0.105) :
curl -X POST https://api.e2x.ai/v1/jobs/submit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit-image",
"input": {
"prompt": "Change the main label title on the amber glass jar to \"BERGAMOT & CEDAR SOY CANDLE\" in the same serif font and gold foil finish. Keep the apothecary jar shape, wooden lid, and linen backdrop unchanged.",
"image_urls": [
"https://example.com/assets/amber-jar-original.png"
],
"aspect_ratio": "4:5",
"resolution": "2K",
"quality": "xhigh"
}
}'
Voici ci-dessous un exemple complet en Node.js qui assemble deux images de référence en 1K ($0.0525) et interroge la tâche jusqu'à son achèvement :
const headers = {
Authorization: `Bearer ${process.env.E2X_API_KEY}`,
"Content-Type": "application/json",
};
const createJob = await fetch("https://api.e2x.ai/v1/jobs/submit", {
method: "POST",
headers,
body: JSON.stringify({
model: "openai/gpt-image-2.5-sunburst/edit-image",
input: {
prompt: "Place the titanium chronograph watch from image 1 onto the wet slate block in image 2. Match the cool side-lighting from image 2 and keep the sub-dial numerals sharp.",
image_urls: [
"https://example.com/assets/chronograph-front.png",
"https://example.com/assets/wet-slate-surface.jpg",
],
aspect_ratio: "1:1",
resolution: "1K",
quality: "max",
},
}),
}).then((res) => res.json());
const jobId = createJob.data.jobId;
while (true) {
await new Promise((r) => setTimeout(r, 3000));
const statusPayload = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, {
headers,
}).then((res) => res.json());
const state = statusPayload.data.status;
if (state === "completed") {
console.log("Edited output URL:", statusPayload.data.outputs[0].url);
break;
}
if (state === "failed" || state === "cancelled") {
throw new Error(statusPayload.data.error?.message || `Edit job ${state}`);
}
}
Chaque URL figurant dans image_urls doit être accessible publiquement en HTTPS afin que nos workers puissent récupérer le fichier source. Vous pouvez inspecter la définition complète des paramètres dans la spécification du point de terminaison lisible par machine ou réaliser l'intégration via nos SDK officiels.
Comparaison des points de terminaison d'édition d'images sur E2X
Choisissez parmi nos six points de terminaison image-vers-image selon que votre retouche porte sur la typographie, les détourages transparents, l'identité de portrait ou le coût à grand volume :
| Modèle d'édition | Prix 1K | Prix 4K | Résolution max | Avantage clé |
|---|
| GPT Image 2.5 Sunburst edit | $0.0525 | $0.1575 | 4K | Prompts de 50 000 caractères, paliers de qualité xhigh et max sans surcoût, format auto |
| GPT Image 2 edit | $0.0525 | $0.1575 | 4K | Prend en charge background: "transparent" pour les détourages PNG avec canal alpha au même prix |
| Nano Banana 2.1 edit | $0.0300 | $0.0900 | 4K | Tarif d'édition 4K le plus bas ($0.09) et 15 formats jusqu'à 8:1 |
| Nano Banana Pro edit | $0.0750 | $0.1500 | 4K | Meilleure préservation de l'identité faciale sur plusieurs références de personnages |
| Nano Banana 2 edit | $0.0400 | $0.0800 | 4K | Changements d'arrière-plan et ajustements colorimétriques rapides au quotidien |
| Nano Banana 2 Lite edit | $0.0238 | n/a | 1K | Coût d'édition 1K fixe le plus bas pour les pipelines de catalogues en masse |
Lorsqu'une édition nécessite un arrière-plan PNG transparent (background: "transparent"), utilisez GPT Image 2 edit-image au même tarif de $0.0525 (1K), car gpt-image-2.5-sunburst/edit-image n'expose pas le champ background. Lorsque vous avez besoin d'éditions 4K économiques à grande échelle ($0.09) ou de bannières ultra-larges 8:1, utilisez Nano Banana 2.1 edit-image. Parcourez tous les modèles d'édition dans la catégorie image-vers-image ou dans le catalogue complet de modèles.
Rédiger des prompts d'édition efficaces
Un prompt d'édition fonctionne mieux lorsqu'il décrit la modification plutôt que de redécrire toute l'image source depuis le début :
- Nommez ce qui change et ce qui reste verrouillé : Indiquez explicitement quels éléments doivent rester intacts (« remplacez le plateau en bois par du marbre de Carrare adouci ; gardez la tasse en céramique, la vapeur et l'angle de l'anse inchangés »).
- Indexez clairement plusieurs images de référence : Lorsque vous passez deux URL ou plus dans
image_urls, désignez-les par leur position (« prenez la basket de l'image 1, placez-la sur la rue en asphalte mouillé de l'image 2 et harmonisez les reflets néon de l'image 3 »).
- Citez le texte de remplacement mot pour mot : Placez le texte de remplacement exact entre guillemets doubles et précisez comment il doit s'intégrer à la typographie existante (« remplacez le texte du badge par "LIMITED EDITION 250ML" dans la même police sans-serif condensée »).
- Adaptez le format d'image à la source ou utilisez
auto : Définir aspect_ratio: "auto" permet au modèle de conserver le cadrage de votre image d'entrée, tandis que spécifier 16:9 ou 9:16 lui demande de recadrer ou d'étendre la scène pour l'adapter au nouveau canevas.
Pour découvrir d'autres exemples de flux de travail pilotés par référence, consultez notre guide de génération d'images cohérentes ainsi que notre comparaison des modèles Nano Banana.
Questions fréquemment posées
Combien coûte une seule édition GPT Image 2.5 Sunburst sur E2X ?
Après notre remise de 75 %, une édition est facturée $0.0525 à resolution: "1K" (par défaut), $0.105 en 2K et $0.1575 en 4K, que quality soit réglé sur low, medium, high, xhigh ou max.
Quels paramètres sont obligatoires sur le point de terminaison edit-image ?
Seuls prompt (jusqu'à 50 000 caractères) et image_urls (un tableau contenant au moins une URL d'image accessible publiquement) sont obligatoires. aspect_ratio, resolution et quality sont facultatifs et prennent par défaut les valeurs "1:1", "1K" et "high".
En quoi GPT Image 2.5 Sunburst edit-image diffère-t-il de GPT Image 2 edit-image ?
Les deux points de terminaison partagent la même grille tarifaire ($0.0525 pour 1K, $0.105 pour 2K et $0.1575 pour 4K). Sur GPT Image 2.5 Sunburst, quality est facultatif et ajoute les paliers xhigh et max sans coût supplémentaire, et aspect_ratio ajoute "auto" aux 15 ratios fixes. En revanche, gpt-image-2.5-sunburst/edit-image n'inclut pas le paramètre de transparence background présent sur gpt-image-2/edit-image.
Puis-je passer plusieurs images de référence dans une seule requête ?
Oui. image_urls accepte un tableau d'URL sources afin que vous puissiez combiner des sujets, des arrière-plans et des références de style au sein d'une même tâche. Mentionnez chaque image par son numéro dans votre prompt (« image 1 », « image 2 ») pour que le modèle sache quel rôle joue chaque fichier.
Pourquoi la limite de prompt est-elle de 50 000 caractères ici au lieu de 32 000 ?
Les pipelines d'édition basés sur des références injectent souvent des contraintes de mise en page structurées, des transcriptions OCR d'étiquettes existantes et des instructions de conditionnement propres à chaque image. Le plafond de 50 000 caractères accueille ces charges utiles automatisées plus longues sans troncature.
Comment maintenir des coûts d'itération bas lors de la mise au point d'une édition ?
Conservez resolution: "1K" pendant que vous testez la formulation du prompt et le placement de la composition en qualité high, xhigh ou max. Chaque passe 1K coûte alors $0.0525 au lieu de $0.105 (2K) ou $0.1575 (4K). Ne passez resolution à 2K ou 4K que pour l'export final.
Quand dois-je plutôt choisir Nano Banana Pro ou Nano Banana 2.1 pour l'édition ?
Choisissez Nano Banana Pro ($0.075 en 1K) lorsque la préservation de la ressemblance faciale d'une personne précise sous plusieurs angles de référence est la priorité absolue. Choisissez Nano Banana 2.1 ($0.03 pour les éditions 1K et $0.09 pour les éditions 4K) si vous avez besoin du tarif d'édition 4K le plus bas sur E2X ou de formats d'image extrêmes 8:1 et 1:8.