Que faire si gpt-image-2 ne peut plus générer de fond transparent ? Passez à la série 2.5 en 3 étapes pour retrouver un fond transparent

Note de l’auteur : OpenAI a officiellement désactivé la prise en charge des arrière-plans transparents dans gpt-image-2. Cet article explique l’origine de l’erreur et présente une méthode pour migrer vers la série 2.5 en changeant simplement le nom du modèle, afin de générer à nouveau des PNG avec fond transparent.

Ces derniers temps, de nombreux développeurs nous ont signalé que leurs requêtes gpt-image-2 avec fond transparent, qui fonctionnaient jusque-là sans problème, renvoyaient soudainement l’erreur Transparent background is not supported for this model.. Ce n’est ni une erreur dans vos paramètres ni un problème d’API : OpenAI a officiellement désactivé la prise en charge de background: "transparent" dans gpt-image-2 le 2026-09-30.

Il ne s’agit pas d’une restriction temporaire de la plateforme, mais d’un changement opéré par OpenAI. Lors de nos nouveaux tests du 15 octobre, les requêtes avec fond transparent ont été refusées par OpenAI dans les 14 essais de génération texte vers image et les 7 essais de retouche d’image. Les requêtes avec opaque, auto ou sans paramètre background ont toutes généré des images normalement.

Ce que vous allez apprendre : cet article vous aidera à comprendre pourquoi gpt-image-2 renvoie une erreur avec un fond transparent. Vous découvrirez aussi comment migrer vers gpt-image-2.5-flare et gpt-image-2.5-sunburst. Il suffit généralement de changer le nom du modèle sur une seule ligne pour rétablir la génération avec fond transparent.

Points clés sur l’erreur de fond transparent avec gpt-image-2

Commençons par un exemple typique de requête en erreur. L’utilisateur envoie les paramètres suivants à gpt-image-2 pour obtenir un PNG sans arrière-plan, sans bordure et sans halo :

{
  "model": "gpt-image-2",
  "background": "transparent",
  "output_format": "png",
  "quality": "low",
  "size": "2048x2560",
  "n": "1",
  "prompt": "去掉背景，没有边缘，没有光晕"
}

L’API renvoie le corps d’erreur suivant. Les champs importants sont code: invalid_value et param: background :

{
  "error": {
    "code": "invalid_value",
    "message": "Transparent background is not supported for this model.",
    "param": "background",
    "type": "shell_api_error"
  }
}

Le message d’erreur identifie clairement le paramètre en cause. Le tableau ci-dessous récapitule les points essentiels :

Pourquoi l’arrière-plan transparent de gpt-image-2 a-t-il été désactivé ?

La chronologie montre que l’arrière-plan transparent de gpt-image-2 n’a jamais été une fonctionnalité officielle. Disponible depuis le 21 août 2026 sous forme de preview, il s’agissait d’une phase d’essai. Le 30 septembre, OpenAI a mis fin à cette preview et demandé aux utilisateurs qui ont besoin d’un fond transparent de passer aux deux modèles de la série 2.5 qui le prennent en charge nativement.

Cela explique pourquoi certains développeurs ont l’impression que « tout fonctionnait encore il y a deux mois ». Si votre projet a intégré l’arrière-plan transparent entre la fin août et septembre, il utilisait en réalité une fonctionnalité en preview. Il est donc normal qu’elle ne fonctionne plus depuis sa désactivation. Comme le refus vient directement d’OpenAI, aucun service proxy API ni aucune plateforme d’agrégation ne peut contourner cette restriction. La bonne solution consiste à changer de modèle.

Quels paramètres background sont encore utilisables avec gpt-image-2 ?

Beaucoup craignent que gpt-image-2 ne soit plus utilisable du tout, mais ce n’est pas le cas. Seule la valeur transparent a été désactivée ; les autres modes d’arrière-plan fonctionnent normalement. Voici les résultats de nos nouveaux tests effectués le 15 octobre :

Ainsi, si seuls certains cas d’usage de votre activité nécessitent un fond transparent, il n’est pas nécessaire de changer de modèle partout. Une approche raisonnable consiste à continuer d’utiliser gpt-image-2 pour les générations classiques et à router uniquement les requêtes nécessitant un fond transparent vers la série 2.5.

Migration vers un fond transparent avec gpt-image-2 : démarrer en 3 étapes

Le principe de la migration est simple : changez le nom du modèle selon l’usage et conservez tous les autres paramètres. Les trois modèles ont le même prix et les mêmes paramètres : vous n’avez pas besoin de modifier size, quality, output_format ni votre invite.

Voici les 3 étapes à suivre :

1. Repérez les requêtes : recherchez background="transparent" ou "background": "transparent" dans votre code pour trouver tous les appels avec un fond transparent.
2. Remplacez le modèle selon l’usage : utilisez gpt-image-2.5-flare pour les appels à images.generate et gpt-image-2.5-sunburst pour ceux à images.edit.
3. Vérifiez le format de sortie : assurez-vous que output_format est défini sur png ou webp. Le JPEG ne prend pas en charge le canal alpha : même si le modèle gère la transparence, le format JPEG ne permet pas de la conserver.

Exemple minimal avec arrière-plan transparent avec gpt-image-2.5-flare

Voici la manière la plus simple de générer une image avec un arrière-plan transparent à partir d’un texte, à l’aide du SDK Python officiel d’OpenAI :

import base64
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI OpenAI 兼容接口
)

result = client.images.generate(
    model="gpt-image-2.5-flare",       # 原 gpt-image-2 改为 flare
    prompt="一只卡通风格的橙色小狐狸贴纸，干净边缘，无光晕",
    background="transparent",
    output_format="png",
    quality="low",
    size="1024x1024",
    n=1,
)

with open("fox.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Petit détail à noter : dans la requête de référence, n est transmis sous forme de chaîne ("1"). Il est préférable d’utiliser l’entier 1 pour éviter les erreurs de type avec certains SDK ou dans les contextes où la validation est stricte.

Exemple de modification d’image avec gpt-image-2.5-sunburst et bascule automatique

Si vous voulez « supprimer l’arrière-plan d’une image existante », il s’agit à proprement parler d’une modification d’image. Il vaut donc mieux utiliser l’interface d’édition avec gpt-image-2.5-sunburst. Cette approche correspond davantage à l’usage prévu du modèle que de demander « supprime l’arrière-plan » dans une invite de génération texte vers image.

Le code complet ci-dessous regroupe deux fonctions : l’une pour générer des images, l’autre pour les modifier. Il intègre aussi un mécanisme de secours : si du code existant envoie encore une demande de transparence à gpt-image-2, une erreur 400 contenant param=background déclenche automatiquement une nouvelle tentative avec le modèle 2.5 correspondant.

import base64
from typing import Optional
from openai import OpenAI, BadRequestError

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # Interface unifiée APIYI : une seule clé pour appeler trois modèles
)

# Correspondance des modèles pour les arrière-plans transparents
TRANSPARENT_MODEL = {
    "generate": "gpt-image-2.5-flare",     # Texte vers image
    "edit": "gpt-image-2.5-sunburst",      # Modification / édition d’image
}


def pick_model(task: str, background: Optional[str], model: str) -> str:
    """Sélectionne automatiquement un modèle de la série 2.5 en cas de demande d’arrière-plan transparent"""
    if background == "transparent" and model == "gpt-image-2":
        return TRANSPARENT_MODEL[task]
    return model


def is_transparent_rejected(err: BadRequestError) -> bool:
    """Identifie l’erreur 400 indiquant que gpt-image-2 refuse un arrière-plan transparent"""
    msg = str(err)
    return "Transparent background is not supported" in msg or "background" in msg


def save_b64(b64_data: str, path: str) -> str:
    with open(path, "wb") as f:
        f.write(base64.b64decode(b64_data))
    return path


def generate_image(
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    size: str = "1024x1024",
    quality: str = "low",
    output_format: str = "png",
) -> str:
    params = dict(
        prompt=prompt,
        size=size,
        quality=quality,
        output_format=output_format,
        n=1,
    )
    if background:
        params["background"] = background

    target = pick_model("generate", background, model)
    try:
        result = client.images.generate(model=target, **params)
    except BadRequestError as e:
        if is_transparent_rejected(e) and target == "gpt-image-2":
            result = client.images.generate(
                model=TRANSPARENT_MODEL["generate"], **params
            )
        else:
            raise
    return save_b64(result.data[0].b64_json, out_path)


def edit_image(
    image_path: str,
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    output_format: str = "png",
) -> str:
    target = pick_model("edit", background, model)
    with open(image_path, "rb") as img:
        kwargs = dict(
            image=img,
            prompt=prompt,
            output_format=output_format,
            n=1,
        )
        if background:
            kwargs["background"] = background
        result = client.images.edit(model=target, **kwargs)
    return save_b64(result.data[0].b64_json, out_path)


if __name__ == "__main__":
    # Génération d’une image sur fond transparent : utilise automatiquement gpt-image-2.5-flare
    generate_image("极简风格的咖啡杯图标，扁平设计", "cup.png")

    # Suppression de l’arrière-plan : utilise automatiquement gpt-image-2.5-sunburst
    edit_image("product.jpg", "去掉背景，保留主体，没有边缘，没有光晕", "product_cut.png")

Conseil pour démarrer rapidement : si votre projet utilise à la fois gpt-image-2 et la série 2.5, nous vous recommandons de passer par APIYI apiyi.com pour tout centraliser. Une seule clé API suffit pour appeler les trois modèles. Les nouveaux utilisateurs bénéficient d’un crédit d’essai gratuit, idéal pour vérifier le rendu sur fond transparent avant la migration.

Comparaison des solutions de remplacement pour les arrière-plans transparents avec gpt-image-2

Au lieu de passer directement à la série 2.5, certains envisagent de générer d’abord une image sur fond blanc avec gpt-image-2, puis de supprimer l’arrière-plan à l’aide d’un outil de détourage. Ces deux approches répondent à des besoins différents. Voici une comparaison :

Comment choisir une solution d’arrière-plan transparent pour gpt-image-2

Comparaison avec le détourage en post-traitement : l’avantage de la solution « fond blanc + détourage » est qu’elle permet de conserver pleinement le style visuel de gpt-image-2. En revanche, elle ajoute une étape de traitement. Les cheveux fins, le verre semi-transparent et les ombres portées risquent de présenter des bordures blanches ou des halos. C’est précisément le type de problème que l’utilisateur de la requête de référence cherchait à exclure de son invite. À l’inverse, la série 2.5 génère nativement un canal de transparence : le processus est plus court et convient mieux à la production automatisée en série.

Comparaison avec la série 2.5 : gpt-image-2.5-flare et gpt-image-2.5-sunburst sont les modèles de remplacement pour les arrière-plans transparents officiellement désignés par OpenAI. Ils ont le même tarif et les mêmes paramètres, ce qui rend la migration presque gratuite. Pour les nouveaux projets ou les équipes qui ne disposent pas déjà d’une chaîne de détourage, passer directement à la série 2.5 est le choix le plus sûr.

Remarque sur la comparaison : les résultats réels dépendent étroitement du type de visuels utilisés. Nous vous conseillons de tester la même série d’invites sur APIYI apiyi.com, puis de comparer la qualité des contours avant de choisir une solution pour la production.

FAQ

Points clés de la migration de l’arrière-plan transparent de gpt-image-2

• Arrêt de la fonctionnalité : OpenAI a désactivé le 30 septembre 2026 la prise en charge de l’arrière-plan transparent en preview de gpt-image-2.
• Caractéristiques de l’erreur : HTTP 400, invalid_value, param: background. Les requêtes rejetées ne sont pas facturées.
• Fonctionnalités toujours disponibles : les arrière-plans opaques, le mode auto et les requêtes sans paramètre background fonctionnent toujours avec gpt-image-2.
• Alternative pour le texte vers image : pour générer des images avec un fond transparent, utilisez gpt-image-2.5-flare ; il suffit de changer le nom du modèle.
• Alternative pour la retouche d’image : pour retoucher des images avec un fond transparent, utilisez gpt-image-2.5-sunburst. Les trois modèles ont le même prix et les mêmes paramètres.
• Format à retenir : pour obtenir une image transparente, utilisez impérativement le format png ou webp. Le JPEG ne prend pas en charge le canal alpha.
• Pour commencer : avec APIYI, sur apiyi.com, un seul clé API permet d’appeler les trois modèles. Faites un test gratuit avant la migration.

Résumé

Si gpt-image-2 ne peut pas générer d’images avec un arrière-plan transparent, ce n’est pas à cause de votre code : OpenAI a officiellement désactivé cette fonctionnalité en preview. Voici les solutions à retenir :

1. Confirmer la cause : le message Transparent background is not supported for this model. indique que la fonctionnalité a été désactivée par OpenAI. La requête n’est pas facturée : inutile de réessayer.
2. Choisir le modèle selon le cas d’usage : passez à gpt-image-2.5-flare pour le texte vers image et à gpt-image-2.5-sunburst pour la retouche d’image. Conservez tous les autres paramètres.
3. Prévoir une solution de repli : ajoutez une correspondance entre les modèles et une logique de repli en cas d’erreur 400 dans la couche d’appel, et veillez à utiliser le format png ou webp en sortie.

Pour la plupart des projets, la migration se résume à changer le nom du modèle sur une seule ligne. Nous vous recommandons de tester rapidement le rendu avec fond transparent de la série 2.5 via APIYI, sur apiyi.com. La plateforme propose une interface compatible avec OpenAI et un quota gratuit pour les tests, ce qui facilite le passage d’un modèle à l’autre entre gpt-image-2 et la série 2.5.

📚 Références

1. Documentation d’aide d’APIYI : FAQ sur les arrière-plans transparents des images : explication de la désactivation de la prise en charge des arrière-plans transparents dans gpt-image-2 et guide de migration
2. Lien : docs.apiyi.com/faq/image-transparent-background

3. À retenir : cette page présente les messages d’erreur, les modèles de remplacement et un tableau de correspondance des paramètres pour faciliter les vérifications lors de la migration.

4. Documentation de l’API de génération d’images d’OpenAI : description des paramètres des interfaces images.generate et images.edit

5. Lien : platform.openai.com/docs/guides/image-generation

6. À retenir : consultez la définition officielle des paramètres background, output_format, quality, entre autres.

7. SDK Python d’OpenAI : code source et exemples du client Python officiel

8. Lien : github.com/openai/openai-python
9. À retenir : les exemples de code de cet article s’appuient sur ce SDK. Vous pouvez consulter sa documentation pour en savoir plus sur les types d’exceptions et l’utilisation des interfaces d’image.

Auteur : équipe technique d’APIYI
Échanges techniques : contactez-nous depuis la page d’accueil du site d’APIYI. Pour consulter d’autres ressources sur l’intégration de modèles d’image, rendez-vous dans le centre de documentation sur docs.apiyi.com.

Articles connexes

• Résoudre le problème des bandes colorées lors de la génération d’images avec GPT Image 2.5 : diagnostic de 5 types de bandes colorées et guide de sélection du paramètre quality: Décomposez les 5 types et causes des bandes colorées et du bruit coloré lors de la génération d’images avec gpt-image-2.5-sunburst, expliquez le lien entre les niveaux de qualité et le budget de calcul, donnez la conversion « 2.5 high ≈ 2 medium », comparez les coûts et proposez des solutions pour les éliminer sans trop augmenter le budget.
• 2 méthodes pour générer des ensembles d’images e-commerce avec gpt-image-2 : image unique multidimensionnelle vs décomposition textuelle + appels concurrents (avec code complet): L'API gpt-image-2 ne traite qu'une invite par requête et le paramètre n ne fait que varier l'image ; 2 solutions e-commerce : une image multidimensionnelle, ou un modèle texte comme gpt-6.1-sol pour découper le storyboard puis appeler gpt-image-2 en parallèle, avec code et cohérence de style.
• Les compagnons de bureau IA envahissent les écrans : créez un personnage avec Nano Banana, générez des mouvements sur fond vert avec Seedance et détourerez en 3 étapes un compagnon animé à fond transparent: Tutoriel de création d’un compagnon de bureau IA principalement via une interface graphique : concevez votre personnage avec Nano Banana, générez des vidéos d’action sur fond vert avec Seedance, puis utilisez la chaîne de ressources dsh-pet pour détourer les vidéos en WebM transparent et les intégrer à DSH afin de créer un compagnon animé.
• Que faire si gpt-6-astra est dégradé ? Guide pratique en 5 étapes de dépannage et utilisation d'une clé API en remplacement temporaire après épuisement du quota: Pour remédier à la baisse de performance de gpt-6-astra et à l'épuisement des quotas de ChatGPT/Codex, voici une méthode de diagnostic en 5 étapes pour identifier les causes de la dégradation, ainsi qu'une solution complète incluant l'utilisation de la clé API officielle, le contrôle de l'intensité d'inférence et l'optimisation du taux de succès du cache.