Tutoriel

Créer un PNG transparent avec Seedream 5.5 et vérifier son alpha

Q: Écrire « fond transparent » dans l’invite suffit-il ?

Utilisez aussi le réglage explicite du fond. auto laisse ce choix au modèle, et l’invite seule ne vérifie pas le contenu du fichier.

Q: Puis-je demander un JPEG pour un élément transparent ?

Pas sur cette route. Associez background: transparent à output_format: png ; la combinaison transparence/JPEG est rejetée.

Créez un PNG transparent avec Seedream 5.5, vérifiez l’alpha et les contours, puis préservez la transparence à l’export. Réglages EvoLink et contrôle local.

JaceyFounder

13 novembre 202610 min de lecture

Dans cet article

Pour créer un PNG transparent avec Seedream 5.5 sur EvoLink, choisissez le modèle de génération/retouche, réglez background sur transparent et conservez output_format: png. Téléchargez ensuite le résultat original et examinez son canal alpha et ses contours. Un aperçu blanc, l’extension .png ou le mot « transparent » dans une invite ne prouvent pas que le fichier livré est exploitable.

Ce flux convient aux produits détourés, autocollants, icônes et autres éléments destinés à une nouvelle composition. Il décrit des réglages documentés et des contrôles de fichier, pas un benchmark de qualité. ByteDance présente la génération RGBA native à partir de texte ou de références dans son guide officiel ; les champs ci-dessous suivent la route propre à EvoLink.

Choisir le livrable avant de générer

Le canal alpha contrôle la façon dont chaque pixel se mélange avec le fond placé derrière lui. Il est distinct de la couleur RGB : un objet blanc peut être opaque alors que son pourtour est transparent. Un alpha partiel peut conserver un contour doux ou une ombre, mais nécessite toujours une inspection visuelle.

Besoin	Choix	Livrable
Une image complète sur fond uni	Génération classique ou retouche avec références	Une image aplatie
Un élément détouré ou une composition transparente	Le même modèle avec sortie PNG transparente	Une image aplatie avec alpha
Plusieurs éléments à déplacer séparément	Le modèle Layerize distinct	Une base, des calques PNG et des métadonnées de placement
Du texte natif modifiable ou un PSD	Une application d’édition après génération ou décomposition	Des objets texte ou un document reconstruits dans l’application

Plusieurs autocollants réunis dans un PNG transparent restent une seule image. La transparence ne les sépare pas automatiquement en calques. Consultez la sélection du modèle si cette distinction change votre tâche.

Générer à partir de texte ou d’une référence

Décrire clairement un seul élément

Dans le Playground, choisissez Seedream 5.5, réglez Background → transparent et utilisez PNG. Sélectionnez une résolution prise en charge et un ratio adaptés à la mise en page finale.

Exemple : « Une seule sculpture en céramique bleu cobalt en forme de ruban, centrée, silhouette complète visible, isolée sur fond transparent, sans texte ni décor. » Il s’agit d’une instruction d’exemple, pas d’un résultat obtenu. Nommez l’objet et ses limites ; ne demandez pas de mur de studio ou de table si ces éléments deviendraient un fond indésirable.

Pour un produit ou personnage existant, ajoutez des références et précisez ce qui doit être conservé. Le modèle classique de génération/retouche d’EvoLink accepte jusqu’à 10 références, sans alpha préalable obligatoire. Chaque référence est facturée en entrée : commencez par les éléments réellement nécessaires. Les tarifs et estimations actuels restent dans la section prix existante.

Préciser la sortie dans la requête API

Utilisez doubao-seedream-5.5 pour la génération d’images à partir de texte comme pour la retouche guidée par références. Gardez la clé API côté serveur. Cet exemple de génération à partir de texte n’inclut pas de référence :

curl -X POST https://api.evolink.ai/v1/images/generations \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5.5",
    "prompt": "A single cobalt-blue ceramic ribbon sculpture, centered, complete silhouette visible, isolated on a transparent background, no text or surrounding scene.",
    "size": "1:1",
    "quality": "1.5K",
    "background": "transparent",
    "output_format": "png"
  }'

Pour la retouche avec références, ajoutez le tableau image_urls contenant les URL accessibles des images d’entrée. Ne copiez pas l’ID d’un autre fournisseur ni son champ image dans cette requête.

auto laisse le modèle choisir le fond ; ce n’est pas une garantie de transparence. Cette route EvoLink rejette l’association de transparent et jpeg. La documentation API de génération et de retouche fournit le contrat complet et les limites.

Attendre la fin et conserver le fichier original

La réponse de création contient une tâche, pas l’image terminée. Conservez son id et remplacez YOUR_TASK_ID dans la requête suivante :

curl https://api.evolink.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $EVOLINK_API_KEY"

Vérifiez le statut. Après completed, téléchargez le résultat à l’URL d’image renvoyée. Traitez failed comme un échec, sans considérer une image absente comme un résultat exploitable. Un callback HTTPS constitue une autre voie de notification documentée. Les métadonnées de fond sont utiles, mais ne remplacent pas l’examen du fichier téléchargé. Enregistrez rapidement votre propre copie plutôt que de dépendre durablement d’un lien temporaire.

La documentation des tâches place les URL de téléchargement dans results ; result_data contient les métadonnées propres au modèle, comme le fond indiqué. Conservez la réponse complète avec le fichier téléchargé. Une étiquette ne remplace pas son contrôle. Aucune requête à l’API de modèle EvoLink n’a été exécutée pour ce guide : l’exemple a été vérifié dans la documentation et le script de fichier a été exécuté localement.

Vérifier le PNG téléchargé

Ouvrez l’original dans un éditeur affichant la transparence. Le damier est une convention d’affichage : un modèle ou un export peut aussi l’inscrire dans les pixels ordinaires. Renommer un JPEG en .png ne crée pas de canal alpha.

Exemple officiel BytePlus d’une création acrylique transparente avec Seedream 5.5

Exemple officiel du guide BytePlus Seedream 5.5, réduit pour l’affichage ; ce n’est pas un test EvoLink. Téléchargez le PNG original pour examiner le fichier plutôt que l’aperçu web.

Pour un contrôle local rapide, installez Pillow avec python -m pip install pillow, enregistrez ce code dans check_alpha.py, puis lancez python check_alpha.py asset.png :

import sys
from PIL import Image

with Image.open(sys.argv[1]) as image:
    if image.format != "PNG":
        raise ValueError("The downloaded file is not PNG")
    alpha = image.convert("RGBA").getchannel("A")
    minimum, maximum = alpha.getextrema()
    print(f"8-bit alpha range: {minimum}..{maximum}")
    if minimum == 255:
        print("No transparent pixels")
    elif maximum == 0:
        print("Fully transparent: no visible subject")
    else:
        print("Transparency exists; inspect edges and subject")

La conversion RGBA permet également de vérifier une transparence de palette. Dans le canal alpha 8 bits examiné, 0 signifie transparent et 255 opaque. La présence de pixels transparents ne prouve pas que les contours sont corrects, que le verre est convaincant ou que les détails du produit sont préservés. Il s’agit d’un contrôle de fichier, pas d’une note de qualité visuelle.

Examiner les contours sur le fond de destination

Schéma du même élément vérifié sur des fonds clair, sombre et coloré

Schéma de contrôle, pas une sortie du modèle. Examinez le même élément sur des fonds contrastés avant validation.

Placez le PNG sur un fond clair, un fond sombre et la couleur réelle de la campagne ou de l’interface. Examinez-le à la taille de livraison et zoomez si nécessaire :

Repérez les halos clairs ou sombres autour de la silhouette, surtout si la référence avait un fond uni.
Vérifiez les petits espaces, cheveux, poils et structures fines : parties manquantes ou pixels de fond restants.
Évaluez les ombres douces et zones translucides dans leur contexte ; tous les contours ne doivent pas devenir entièrement opaques ou transparents.
Contrôlez la forme, la marque et le texte du sujet. Une image techniquement transparente peut représenter le mauvais produit.

Un élément blanc qui disparaît sur blanc peut être correct : vérifiez-le sur une autre couleur. Si le sujet est exploitable et le défaut limité à un contour, un éditeur peut être la bonne étape suivante. Régénérez lorsque l’objet ou la composition est incorrect, plutôt que de multiplier les requêtes pour corriger une erreur d’export.

Conserver la transparence jusqu’à la livraison

Gardez le PNG original comme fichier maître réutilisable. Placez-le comme image dans l’éditeur ou l’application ; déplacer l’image ne rend pas son texte modifiable séparément. Si vous exportez une publicité finale opaque, conservez aussi le maître transparent pour les variantes ultérieures.

Inspectez ce que votre produit sert réellement après importation, optimisation ou export. Une chaîne de traitement peut aplatir l’alpha sur blanc ou convertir le fichier dans un format incompatible, même si la source téléchargée est correcte. Comparez source et fichier livré avant d’accuser le modèle ou de générer une autre image.

Symptôme	Premier contrôle	Suite
Le fond blanc reste présent	Réglages réellement envoyés et alpha téléchargé	Demander explicitement un PNG transparent si la source est opaque
Le damier apparaît dans le design final	Le motif est-il inscrit dans les pixels ?	Remplacer le fond ou régénérer ; un motif d’aperçu n’est pas de l’alpha
Correct en local, opaque après importation	Format servi et traitements	Préserver l’alpha tout au long de la livraison
Les éléments ne bougent pas séparément	Une seule image aplatie a-t-elle été demandée ?	Utiliser Layerize si des éléments indépendants sont réellement nécessaires

Pour les générations et retouches répétées, EvoLink permet de garder la même clé, le même solde et le même flux asynchrone tout en choisissant le modèle adapté. Essayez un élément transparent dans le Playground ou comparez la famille Seedream pour choisir une version.

Questions fréquentes

Seedream 5.5 peut-il générer une image transparente à partir de texte seul ?

Oui. La route documentée d’EvoLink prend en charge cette sortie. Choisissez background: transparent et PNG ; aucune référence n’est nécessaire.

Mon image de référence doit-elle déjà avoir un canal alpha ?

Non. La retouche avec Seedream 5.5 n’exige pas d’alpha préexistant. La route classique accepte jusqu’à 10 références ; inspectez le détourage avant utilisation.

Écrire « fond transparent » dans l’invite suffit-il ?

Utilisez aussi le réglage explicite du fond. auto laisse ce choix au modèle, et l’invite seule ne vérifie pas le contenu du fichier.

Puis-je demander un JPEG pour un élément transparent ?

Pas sur cette route. Associez background: transparent à output_format: png ; la combinaison transparence/JPEG est rejetée.

Pourquoi un PNG paraît-il toujours blanc ?

Il peut être affiché sur blanc ou contenir un véritable fond blanc opaque. Vérifiez l’alpha original et placez l’image sur un fond contrasté.

Un canal alpha valide garantit-il des contours propres ?

Non. Examinez halos, structures fines, ombres, identité du sujet et texte à la taille prévue. Le script vérifie uniquement la transparence des pixels.

Faut-il Layerize pour une sortie transparente ?

Non. La génération/retouche classique peut renvoyer un PNG transparent unique. Choisissez Layerize pour des éléments indépendants et leurs métadonnées de placement ; il ne livre directement ni PSD ni objets texte natifs.

Où consulter le coût actuel ?

Dans les tarifs et estimations actuels de la page modèle. La sortie classique et les références utilisées contribuent au coût ; ce guide ne maintient pas une seconde grille tarifaire.

Sources

Guide des capacités Seedream 5.5 de BytePlus : RGBA natif et illustration attribuée.
Documentation API Seedream 5.5 d’EvoLink : ID, contrôles et traitement asynchrone propres à la plateforme.
Spécification PNG du W3C : représentation PNG et alpha.
Référence Pillow Image : conversion et inspection locales des canaux.

Tous les articles

#Seedream 5.5 #Transparent PNG #Image editing #Alpha channel