Introduction
Les calques Seedream 5.5 transforment un PNG ou JPEG terminé en un fond opaque et des éléments transparents séparés. Utilisez la séparation en calques lorsque vous disposez déjà d’un visuel et souhaitez retravailler chaque élément. Ce point de terminaison accepte une seule source.
ByteDance annonce un fond et jusqu’à 99 calques PNG transparents modifiables. Nos essais ont séparé une couverture de magazine, un menu et une affiche à trois lignes. Ils montrent pourquoi le nombre demandé est un plafond : certaines images ont atteint la limite, tandis que l’affiche a produit moins d’éléments.
Fonctionnalités et points forts
Un fond et des éléments transparents
Le fond est opaque et les éléments séparés utilisent la transparence PNG. Choisir jpeg pour output_format change l’encodage du fond ; les calques restent des PNG transparents. Tenez-en compte lors de l’enregistrement des fichiers destinés à une composition. Le fond et les calques jouent des rôles différents.
Chaque calque possède un nom, un cadre de délimitation et un zIndex pour la superposition. Le fond n’a pas de cadre. Conservez ces informations avec les fichiers pour disposer les éléments dans un outil de design. Chaque image renvoyée conserve son propre format.
Un plafond qui inclut le fond
num_outputs accepte de 2 à 100 et vaut 10 par défaut. Comptez le fond comme une sortie pour préparer la séparation. Un plafond de six permet donc un fond et cinq calques transparents. Une valeur élevée donne généralement une séparation plus fine, mais le résultat peut contenir moins d’images.
Dans nos essais, un menu a produit un fond et cinq calques avec une limite de six. Une affiche à trois lignes a produit un fond et trois calques de texte avec une limite de cinq. Un plafond élevé n’oblige donc pas le modèle à utiliser toutes les sorties disponibles.
Des noms anglais sur demande
Les exemples demandent chaque nom et description de calque en anglais. Nos essais ont renvoyé des noms anglais avec cette consigne. Ajoutez « Rédigez chaque nom et description de calque en anglais » si votre travail le nécessite. Distinguez cette demande de la liste des éléments à séparer.
Réglages de source et de résolution
Fournissez un PNG ou JPEG d’au moins 512 x 512 pixels. Les résolutions sont auto, 1k, 1.5k et 2k, avec auto par défaut. Ce sont les choix propres aux calques ; le réglage 4k de génération et de retouche n’est pas disponible ici.
| Réglage | Rôle dans la séparation |
|---|---|
image_url | Fournit le visuel source terminé |
| prompt | Nomme facultativement des éléments ou une zone cible |
| resolution | Sélectionne auto, 1k, 1.5k ou 2k |
num_outputs | Plafonne toutes les images renvoyées, fond compris |
output_format | Choisit PNG ou JPEG pour le fond |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | Fournissez un PNG ou JPEG d’au moins 512 x 512 pixels. Une source est obligatoire ; aucune image n’est fournie par défaut. 1 caractères minimum |
prompt | Non | Facultatif. Nommez les éléments à séparer en 5 000 caractères maximum. 3 caractères minimum · 5000 caractères maximum |
num_outputs | Non | Plafonne le nombre total d’images renvoyées, fond compris : de 2 à 100, avec 10 par défaut. |
resolution | Non | Choisit auto, 1k, 1.5k ou 2k ; auto par défaut. Chaque image renvoyée conserve son propre format. |
output_format | Non | Sélectionnez png (par défaut) ou jpeg pour le fond opaque. Dans les deux cas, les calques séparés restent des PNG transparents. |
Tarification
La facturation dépend du palier de résolution et du nombre d’images réellement renvoyées, fond compris. Le devis réserve le montant maximal correspondant au plafond demandé ; la différence est libérée au décompte final. Le réglage auto réserve le tarif 2k.
| Spécification | Prix |
|---|---|
| $0.0195 / image |
| $0.0195 / image |
| $0.027 / image |
| $0.027 / image |
Cas d’utilisation
Séparer une couverture en éléments graphiques
Notre couverture NOIR a utilisé une limite de six images et en a renvoyé six : un fond, une personne, le nom du magazine, une ligne japonaise, une ligne de numéro et un code-barres. Cet exemple concret associe contenu photographique et lettrage dans les calques Seedream 5.5.
Utilisez ce résultat pour préparer une séparation de visuel aux éléments distincts. Nommez les éléments utiles dans la consigne facultative. Gardez la source disponible pour comparer les fichiers renvoyés à la mise en page d’origine.
Décomposer un menu pour poursuivre la composition
L’exemple KAZE RAMEN part de l’image de menu terminée. Avec un plafond de six images, nos essais ont produit un fond opaque et cinq calques transparents. Enregistrez l’ensemble des sorties si vous comptez ensuite redisposer les éléments du menu.
Isoler les lignes de texte d’une affiche
Notre affiche à trois lignes a produit un calque transparent par ligne, plus le fond. Le total était de quatre images malgré un plafond de cinq. Comptez les éléments réellement renvoyés après traitement, sans considérer la limite demandée comme une liste de fichiers garantis.
Organiser les éléments avec les métadonnées renvoyées
Utilisez le nom pour identifier chaque calque, le cadre de délimitation pour sa position et zIndex pour l’ordre de superposition. Gardez ces valeurs associées au fichier correspondant. Demander des noms anglais facilite cette organisation si le reste du travail utilise des libellés anglais.
Guide de prompt et conseils pratiques
Choisissez une source terminée aux éléments identifiés
Vérifiez que le fichier est un PNG ou JPEG d’au moins 512 x 512 pixels. Déterminez les éléments à récupérer avant de fixer le nombre de sorties. Pour une couverture, listez le fond, la personne, le titre, les textes d’accompagnement et le code-barres si vous en avez besoin.
Nommez la séparation souhaitée
Le prompt est facultatif : vous pouvez envoyer la source sans liste d’éléments. Pour une séparation précise, rédigez une courte consigne comme « Séparez le nom du magazine, le sous-titre, la ligne du numéro et le code-barres ». Vous indiquez ainsi les éléments que vous souhaitez retravailler.
Demandez directement la langue des noms
Ajoutez « Renvoyez les noms de calques en anglais » si nécessaire. Les exemples de couverture et de menu emploient cette consigne. Notre observation linguistique concerne les noms renvoyés ; elle n’implique pas de traduire ou remplacer les textes imprimés dans la source.
Désignez une zone avec une balise de délimitation
Pour cibler une zone, utilisez <bbox>x1 y1 x2 y2</bbox> avec des coordonnées entre 0 et 1000. Par exemple, <bbox>0 0 1000 300</bbox> désigne une zone dans la partie supérieure du visuel. Faites suivre la balise d’une description de l’élément à séparer pour préciser son rôle.
Fixez le nombre selon les éléments nécessaires
Pour un fond et cinq calques, choisissez un plafond de six. Un plafond élevé permet généralement des calques plus fins. Il reste une limite, sans garantie du nombre. Comparez les fichiers renvoyés à la liste prévue avant de poursuivre le travail graphique.
Distinguez le format du fond et la transparence des calques
Choisissez png ou jpeg selon le fichier de fond voulu. Ce choix ne transforme pas les calques séparés en JPEG : ils restent des PNG transparents dans les deux cas. Conservez le fond opaque si la composition complète a besoin de son image sous-jacente.
Comprenez le nombre de sorties au décompte final
La facturation suit le palier de résolution et le nombre d’images réellement renvoyées, fond compris. Le devis réserve le maximum correspondant au plafond demandé et libère la différence au décompte final. La résolution auto réserve le tarif 2k. Consultez le montant affiché sur la page pour choisir les réglages.
Enregistrez le résultat complet
Téléchargez ensemble le fond, les PNG transparents et leurs informations de position. Conservez aussi la consigne facultative et le plafond demandé. Vous gardez ainsi le lien entre le visuel source, les fichiers séparés, leurs noms et leur ordre de superposition pour la prochaine composition.
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": "bytedance/seedream-5.5/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"num_outputs": 10,
"output_format": "png",
"resolution": "auto"
}
}'
# 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.
